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This manual explains how to write programs in the Assembler I 


programming language, and how to assemble these programs. The 
reader should be familiar with the fundamental techniques of 
programming and the operating principles of System Ten. 


Experience with at least one other assembler or class work 
covering Assembler I is desirable. In addition, the System Ten 
Programmer's Machine Reference Manual is recommended as a 
prerequisite. Those using Assembler I in a dise environment 
should also read the Disc Management Facility User's Reference 
Manual. 
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INTRODUCTION 


Assembler I translates symbolically-coded source programs into 
machine-~language object programs that can be executed by System 
Ten. The assembler assigns storage for the machine-language 
instructions, computes absolute addresses from symbolic 
addresses, and performs other functions that aid in preparing 
the object program for loading. The customer may select either 
of two versions of the assembler: 


*Assembler I (Card Version) for operating ina 
card I/O environment. 


*Assembler I (Disc Version) for operating ina 
disc I/O environment. 


The assembler-language coding (described in sections 2 and 3) is 


the same for both versions of the assembler; however, the 
listing output (section 4) and installation and operating 
procedures (section 5) differ for each version. Essentially, 


the card version is loaded into memory manually along with each 
user source program processed. However, the disc version is 
read onto disc storage once, through the Dise Management 
Facility (DMF), and is thereafter called from disc residence 
into memory through DMF each time aouser source program is 
processed. With the disc version, the user source program must 
also be input from a DMF disc file. Throughout this manual, the 
distinction between the card and disc versions of the assembler 
will be stressed only when necessary to point out differences. 
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MEMORY REQUIREMENTS 


The assembler program functions within the partition into which 
it is loaded. The size of the partition and the amount of space 
allotted in common determine the number of labels the assembler 
can process. 


The assembler requires at least a 9K partition. The highest 
available positions of the partition are used for the label 


table. In addition, the label table may overflow into whatever 
common region locations are allowed py the installation 
parameters in the assembler deck. (See Section 5 and Appendix 
A.) 


The maximum number of labelled statements is as follows: 


9K Partition 1OK Partition 
Card Versions: 158 235 
Disc Version: 150 226 


plus 77 labels for each 1001 positions of common core used. 
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Assembler | (Card Version) 


With the card version of the assembler, an input device with 
load capability must be assigned as IOC device O. This device 
is used to begin a load sequence that bootstraps a loader into 
the user's partition, where it remains throughout assembly. The 
following devices possess load capability: 


Model 30 Card Reader 
Model 70 Workstation 
Model 7102 Communications Terminal 


Various devices are required for source program input and 
listing and object program output. The source program can be 
input from the Model 30 Card Reader. 


The listing output (error statement, label table, and program 
listings) can be output to any of the following: 


Model 5O Line Printer 
Model 70 Workstation 
Model 7102 Communications Terminal 


The object program output can be transmitted to the Model 35 
Card Punch. 


As a typical example (figure 1-1), an installation might have a 
Workstation connected as device O to function aS a load device 
and a card reader assigned as device 1 to serve as a source 
input device. A line printer attached as device 2 might act as 
listing device anda card punch attached as device 4 might act 
as object device. 


The particular configuration is flexible. The user may specify 
which device the assembler is to use for source input, for 
listings, and for object program output by using the Assembler 
Deck Parameters described in section 5. The IOC device number 
assignments recommended for standard use are presented in 
appendix G. 
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WORKSTATION 


DISC DRIVE 


CARD READER 


Sy eel TAD 
aoe S723! 


PROCESSOR 


LINE PRINTER 


CARD PUNCH 


Typical Assembly Configuration 


igure 1-1. 


F 


HW-71 


© 1971, The Singer Company 


1-4 


Assembler I 


INTRODUCTION 


Assembler | (Disc Version) 


AUXILIARY 


W-71 


With the disc version of the assembler, the Model 70 Workstation 
or a Model 7102 Communications Terminal is used to call the 
assembler from disc residence into memory through DMF. The 
source program must also be input from a dise file through DMF. 


The disc version of Assembler I uses the permanent logical unit 
assignments from low core for determining the assembler command 
input, listing output, and object output devices. These - 
assignments are established by the permanent mode variant of the 
DMF MAINT ASSIGN function. 


The assembler parameter statements are read from the COMMAND 
logical unit (_LRDR), and can be assigned to the following: 


Model 30 Card Reader 

Model 70 Workstation 

Model 80 Display 

Model 7102 Communications Terminal 
The listing output is transmitted to the PRINT logical unit 
( LLST). This logical unit can be set to IGN (ignore) to 
suppress the listing. The following devices can be assigned as 
PRINT: 

Model 50 Line Printer 

Model 70 Workstation 

Model 7102 Communications Terminal 
The object program can be output to the Model 35 Card Punch or 
to a DMF file on a Model 40 Disc Drive. These assignments are 
controlled by the OBJECT= assembler command when directing the 


object program to disc; when OBJECT= is omitted, the assembler 
defaults to the PUNCH logical unit (which may be IGN). 


SOFTWARE 


The ecard version of the assembler requires a loader capable of 
loading the assembler. 


The disc version of the assembler is installed, loaded, and 
operated in conjunction with DMF. 


In no other respect does the assembler depend upon other 
software. 
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Assembler I 


For each of the 13 System Ten CPU instructions, there is a 
corresponding assembler machine instruction statement. The 
machine instruction statements are listed below and discussed in 
section 2. 


INSTRUCTION NAME : OP CODE 


Add A 
Divide D 
Form Numeric F 
Multiply M 
subtract S 
Compare C 
Exchange Xx 
Edit E 
Move Character M 
Move Numeric M 
Read R 
Write W 
Branch B 


To control the assembly, there are nine assembler commands 
(discussed in section 3): 


COMMON 
END 
EJECT 
EXEC 
NORMAL 
ORG 
SPACE 
TITLE 
DM 


In addition, there are various assembler parameter statements, 
used to specify input/output options. 


For the card version, there are three assembler parameter 
statements: 


DEBUG= 
COMTXT= 
DATE= 


For the dise version, there are six assembler parameter 
statements: 


DEBUG= 
COMTXT= 
DATE= 
XREF= 
SOURCE= 
OBJECT= 
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Unlike machine instruction statements and assembler commands, 
assembler parameter statements are not coded as part of _ the 


user's program. Instead, they are punched on a special 
parameter card in the assembler object deck (in the card 
version) or are entered separately via the Workstation, 


Communications Terminal, or Card Reader (for the disc version). 
Assembler parameter statements are discussed in section 5. 


OF ASSEMBLY PROCESS 


The assembler is essentially a two-pass assembler. That is, it 
makes two passes over the source program. Pass one is’ preceded 
by an initialization phase which establishes assembly parameters 
according to user-supplied parameter statements. Pass two is 
preceded by a printout of the label table. The main steps in 
the process are shown in figure 1-2 and described below. 


1. The loader loads the "Parameter Statement Interpreter" 
program and passes control to it. 


2. The Parameter Statement Interpreter reads any user 
Supplied parameter statements and sets parameters 
accordingly. A unit separator is necessary to return 
control to the loader. 


3. The loader loads Pass One of the assembler program and 
passes control to it. 


4A. The Pass One program reads the source program, checks 
for errors (listing them), and builds the label table. 
The END ecard stops the reading and returns control to 
the loader. 


5. The loader loads the Label Table Printer program and 
passes control to it. 


6. The Label Table Printer program prints the label table 
and passes control to the loader. 


7. The loader loads the Pass Two program and gives control 
LO “ites 


8. The Pass Two program makes the second pass over the 
~gource deck if no errors were detected in Pass. One. 
Pass Two is omitted if errors were detected during Pass 
One. The assembler generates a program listing and 
object deck. Again, the END card returns control to the 
loader. 
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START 


LOAD BASIC 
ASSEMBLER 
PASS 1 PART | 


PROCESS EMBEDDED 
ASSEM 
PARAMETER 
CARDS 


LOAD BASIC 
ASSEMBLER 
PASS 1 PART 2 


OF SOURCE 
PROGRAM 


BUILD LABEL 
TABLE CHECK 
SOURCE 

STATEMENT 
FOR ERRORS 


STATEMENT 
ERROR 


STATEMENT 
ERROR 


YES 
LOAD BASIC 


ASSEMBLER 
PASS 2 PART | 


Figure 1-2. 
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OR STATEMENT 


LOAD BASIC 
ASSEMBLER 
PASS 2 PART2 


ASSEMBLE AND 


RANSLATE 
SOURCE 


STATEMENT TO 
OBJECT FORMAT 


LAST CARD 
? 


YES 


END 
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LABEL TABLE 


The assembler makes two passes over the source program. 


In the first pass, each statement is analyzed for the amount of 
memory it preempts. Each new label enters the label table. For 
each label thus entered, the table shows the address assigned to 
the label by the assembler, an indication as to whether the 
address is in common or partition, an implied length associated 
with the label, and the implied index. 


In the second pass, the assembler substitutes the assigned 
address and common/partition indicator for each use of the label 
in the operand field of instruction statements and produces the 
object deck and listing. If an instruction expects a length 
indication corresponding to a given symbolic address 
specification, and if the programmer omits the length 
specification from the statement, the assembler supplies the 
length from the label table. Similarly, if the instruction 
expects an index indication corresponding to the symbolic 
address specification, and if the programmer omits the index 
specification, the assembler supplies the index from the label 
table. 


In the data definition statements (DM) the programmer can 
exercise direct control over the length and index indications 
entered into the label table for data fields. By exercising 
this control, he is free to omit length and index indications 
from the instructions which manipulate or otherwise use the data 
fields. 


The programmer has no direct control over the length and index 
indications entered into the label table for labelled machine 
instruction statements (which always assume a length of 10 and 
index of 0O). 


SOURCE DECK STRUCTURE 
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A source deck should conform to the following rules of order: 
The TITLE card, if used, must be the first card in the deck. 
The END card must be the last card in the deck. 
From the first card to the END card, every card will be 
treated as a statement. If it cannot be recognized as a 


proper statement, it will be treated as an error. Thus, a 
completely blank card will be treated as an error. 
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For programs where the total storage required is greater than 
the amount of storage available, the programmer may find it best 
to use some type of overlay structure. For example, he may plan 
his program so that a portion is initially loaded into core and 
executed. When execution of the initial load is finished, 
control returns to the loader to load the first overlay into the 
area previously occupied by the initial load. When the first 
overlay is executed, the second overlay is loaded, etc. 


A programmer may invent a variety of ways to use overlays. 
Typically, the loader is kept in core throughout execution 
(locations 50-0299). Return to the loader is accomplished by 
coding a Branch instruction (which passes control to the 
loader's resume loading entry point) at each point in the 
logical flow where loading is desired. 


The coding for the initial load and for the overlays may each be 
thought of as subdecks of the entire source deck. 


The first card of each subdeck is usually an ORG command to 
reset the memory assignment counter and thus’ establish the 
proper load address for the coding which follows. 


The last card of each subdeck is an EXEC command. The EXEC 
command causes the assembler to generate an S card in the object 
deck containing the start address for the overlay. When the 
loader encounters the S card, it stops loading and passes 
control to the start address. 


The last subdeck must be followed by an END card to terminate 
the assembly. 


Figure 1-3 is an example of the program listing generated by an 
overlay program. 


Further directions for using overlays with a disc-oriented 
system are presented in the Disc Management Facility (DMF) 
User's Reference Manual. 
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0001 
LOCN 


0000 
0300 
0300 
0302 
0307 
0380 
0460 
0400 
0402 
0412 
0422 
0460 
0465 
0472 
04380 
0490 
0500 
0510 
0520 
0530 
0540 
0550 
0560 
0570 
0580 
0590 
0600 
0610 
0610 
0480 
0503 
0530 
0540 
0550 
0560 
0570 
0570 


PAGE OOOt1 


LABEL 


AGAIN 
AMOUNT 
EDIT! 
EDIT2 
FINIS 
FINIS2 
HOURS 
HOURSX 
INF O1 
INF Oe 
PRINT 
RATE 
RATEX 
START 
TIMECD 
WORK1 
16 LABEL 
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10/12/71 


INSTR/DATA OP 


0030010080 
SOvPO00N00 
P030020400 
P046050473 
PP30230473 
P047270406 
2PS0030302 
P046570472 
PP30250472 
P047270415 
203X010080 
UOT XO00000 
XOPVO00000 


THE OVERLA 
REPRINT TH 
204X010023 
205P31002e1 
203X010080 
xOUVO00000 


10/12/71 
LOC LNTH JINDX 


0530 
0412 
0460 
0465 
0600 
0560 
0300 
0400 
0480 
0503 
0380 
0302 
0402 
0480 
0300 
0472 
$ 


ooo0oocooco0ooccceo0ocnca 
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A/R 


0300 
0000 
0001 
0001 
0380 
0980 
0400 
0001 
0001 
0001 
0460 
0001 
0001 
0001 
0300 
0600 
0300 
0460 
0302 
0472 
0300 
0465 
0302 
0472 
0380 
0480 
0069 
0489 
0480 
0001 
0001 
0480 
0503 
0380 
0560 
0530 


(4=02) 


tL I Bss 


0080 
0002 
0005 


0001 


000e 
0010 
0010 


0005 
0007 
0007 
0080 
0000 
0400 
0473 
0473 
0406 
0302 
0472 
0472 
0415 
0080 
0000 
0000 


amrnmoeocnoccownod 


0023 
0021 
0023 
0021 
0080 
0000 


L I LINE 


OOrPFN ON WNW OW Cr 


ooocccoooococo 


0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0030 
0031 
0032 
0033 
0034 
0035 
0036 
0037 
0038 


PROGRAM LISTING FOR SYSTEM 10 


LABEL 


TIMECD 
HOURS 
RATE 


PRINT 


HOURS X 
RATEX 
AMOUNT 


EDITL 
EDIT2 
WORK1 
START 


FINIS 


INFO 
INF 02 
AGAIN 


FINIS2 


LABEL TABLE FOR SYSTEM 10 


MESSAGES 


Figure 1-3. 


EXECUTABLE OVERLAY PROGRAM 


OPCODE OPERAND(S) 


ORG 
DM 
DM 
DM 
ORG 
DM 
ORG 
DM 
DM 
OM 
ORG 
DM 
DM 
DM 
R 
BC 
MC 
MC 
E 
MC 


BC 
EXEC 
END 


EXECUTABLE OVERLAY PROGRAM 


TIMECD(O) »80(1) 
FINIS(3) 

HOURS sHOURS X 
EDIT1sWORK1 +1 
RATEs WORK1+1 
WORK1»RATEX+4 
HOURS »RATE 
EDIT2swWORK1 
RATE(5) s#WORK1 
WORK1 » AMOUNT+#3 
PRINT(2)s80(1) 
START(5) 

60(8) 

START 

START 


C'THE OVERLAY HAS OCCURED! 


AND/OR COMMENTS 


*LABELs 


RESERVE NO MEMORY* 


*ADJUST DECIMAL= 2 PLACES LEFT*# 


*CLEAR PRINT AREA TO SPACES* 
*OVERLAY PRINT AREA FOR LABELS* 


*EDIT 
*EDIT 


*UNIT 


*EDIT 


SEPARATOR CHARACTER 


FIELD FOR RATE* 
FIELD FOR AMOUNT* 


(EOF) 


THE MULTIPLIED AMOUNT * 


*GO BACK TO START* 


*GO TO LOADER* 


C'REPRINT THE LAST LINE! 


INFO1(2)223(1) 
INFO2(2)221(1) 
PRINT(2)s80(1) 
FINIS2(8) 
AGAIN 


An Overlay Program 
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Character Set 


* as an 
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- 


The System Ten character set comprises the 64 characters in 
columns 2 thru 5 of the USASCII code chart (see figure 1-4). 


The literal data field of a Define Memory statement may contain 
any of the 64 characters. Since this field is bounded by single 
apostrophes, an apostrophe within the field must be represented 
by two successive apostrophes. 


Address 


An asterisk may be used in the operand field of instruction 
statements to signify the address of the instruction itself. It 
may be used in any of the following three forms: 


* 


* - constant 
* + eonstant 


For example, the Branch instruction 
BC. -*+10(2).;*+40( 5) 


States that if the Condition Code is 2, control passes to the 
instruction immediately following the Branch instruction; if the 
Condition Code is not 2, then control passes (unconditionally) 
to the fourth instruction following the Branch instruction. 


An asterisk may also be used as an address constant in a Define 
Memory statement. Again, it may be used either by itself or 
with a constant (+ or -). 
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Figure 1-4. USASCII and Hollerith Codes 
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SOURCE STATEMENT FIELDS 


A-source statement may contain up to 80 characters. It consists 
of some or all of the following fields in the order shown. The 
label, operation, operand, and comments fields are each 
separated from one another by at least one blank character. 


FIELD REMARKS 


Label Optional. First character 
begins in column l. | 
Exception: In debug state- 
ments, column 1 contains a 
$-sign and the label field 
begins in column 2. 


Operation Required. Preceded and 
followed by at least one 
blank character. 


Operand Optional in some cases. 
Preceded by at least one and 
not more than eight blank 
characters. 


Comments Optional. Preceded by at 
least one blank. 


Continuation Must be blank. Column 70. 
Program Identification Optional. Columns 71-76. 
sequence Number | Optional. Columns 77-80. 


Label Field 


This field, when permitted, is optional. Except for. the 
assembler commands COMMON, NORMAL, END, EJECT, SPACE, and TITLE, 
any statement may be labeled. 


‘If present, the label field consists of 1 to 6 characters, and 
must begin in column 1 of the statement. The first character 
must be from columns 4 or 5 of the USASCII code chart, while 
succeeding characters may be from columns 4, or 5 or O-9 of 
column 3. The label field must be followed by at least one 
blank. 


If the label is omitted, then column 1 of the statement must be 
blank to show that it is omitted. The only exception to this 
rule is the case of the comment statement which begins with an * 
in column l. 
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Typically, the first character of a label is alphabetic, and the 
remaining characters are alphanumeric (A - Z, O - 9). 


Two statements cannot have the same label. 
NOTE 


The following characters should not be used because they are 
reserved for software labels: 


(\JA_ 


Also, the @ Sign must not be used in the label field. 


Operation Field 


Required. This field consists of a keyword mnemonic. For 
example, the mnemonic for the Add instruction is the letter A, 
the mnemonic for the Form Numeric instruction is the pair of 
letters FN, etc. The mnemonic for each machine instruction is 
detailed in Section 2, Machine Instruction Statements, while 
those for the assembler commands are detailed in Section 3, 
Assembler Commands. The operation field must be immediately 
preceded and followed by at least one blank. If an operand 
follows, not more than 8 blanks may intervene. 


The mnemonics for the machine instruction statements are: 


A Add 

BC Branch Conditional 
C Compare 

D Divide 

E Edit 

xX Exchange 

FN Form Numeric 

MC Move Character 

MN Move Numeric 
M Multiply 

R Read 

5 Subtract 

W Write 


The mnemonics for the assembler commands are: 


COMMON 
EJECT 
END 
EXEC 
NORMAL 
ORG 
SPACE 
TITLE 
DM 
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Operand Field 


This field is not expected in the assembler commands COMMON, 
NORMAL, EJECT, and END. In the assembler commands ORG and SPACE 
it is optional. In all other assembler commands, and in all 
machine instructions, the operand field is required. 


The operand field must be immediately preceded by 1-8 blanks. 
It is followed by at least one blank. Its format depends upon 
which mnemonic appears in the operation field. For example, an 
Add instruction requires an operand field of the "two length 
form". The various forms for the machine instructions and 
assembler commands are detailed in section os Machine 
Instruction Statements, and Section 3, Assembler Commands. 


Comments Field 


Program 


Optional. Any statement may contain a comments field. 


If present, it must be separated from the operand field by at 
least one blank, and must not extend beyond column 69. If a 
comments field appears in an ORG or SPACE assembler command 
which has no operand field, then it must be separated from the 
operation field by at least eight blanks. A comments field may 
contain any System Ten character (columns 2, 3, 4, or 5 of the 
USASCII code chart). 


Identification Field 


Optional. This consists of columns 71-76. Whatever is in this 
field of the first line is punched in. columns 71-76 of every 
object card. This field has no effect upon, and does not appear 
in, the program listing. 


Sequence Number Field 


Assembler J 


Optional. This consists of columns 77-80. Whatever is in this 
field is copied to the program listing under the heading SEQ. 
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STANDARD CODING FORMS AND SOURCE CARDS 


Although the programmer is free to vary the spacing between 
fields, he may prefer to use standard System Ten assembler 
coding forms and source cards (figures 1-5 and 1-6). With 
readability in mind, they were designed with the label field 
beginning in column 1, the operation field in column 8, and the 
operand field in column 15. Column 70, which must always be 
blank, is shaded. 


COMMENTS STATEMENT 


A statement which begins with * in column 1 is treated as a 
comment. It is copied to the listing but has no other effect 
upon assembly. 


DEBUG STATEMENT 


11-71 


A statement containing $ in column 1 is ecalled a Debug 
statement. <A Debug statement is ignored by the assembler if the 
assembler parameter DEBUG=NO is in effect. If the assembler 
parameter DEBUG=YES is in effect, the $ is ignored and _ the 
remainder of the statement is assembled. In such a case the 
label field begins in column 2 (instead of column 1, as in a 
non-Debug statement). If the label field is omitted, column 2 
must be blank to show that it is omitted. 


A card containing $* in columns 1,2 is listed as a comment if 
the assembler parameter DEBUG=YES is in effect. The ecard is 
ignored if DEBUG=NO is in effect. DEBUG=NO is the usual default 
case, but it can be DEBUG=YES. The first card of the assembler 
deck contains parameters which determine the default. 


The assembler parameters are discussed in Section 5 and Appendix 
A. 
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SYSTEM TEN SOURCE CARD 


CONTINUATION 


Se eee ee eae TTC UCEULLLGEELLERECLLL) (occ 
LUVQVGUPT EDTA TAT aad 
22222202/022222)2|22222222222222222222222 222222222222 222227222227 22222 22 22 2222 2 222 
$9995131999599191999999933399999933399999933333939393999999999999999999 9189 9999 913 333 
UTEP IVEVETINIVERETYSTTUVITESTVECTVTUTESIVOSTEVITECTICTTCCTICT Teri © (tverr irr 
SHSSH SSS SSS HSSSSSSSSSSSSHSSSSSS HSS SS HSH HSS SS SS SSS SSS HS HHS SHS S HSH FSGS Hols 5555 5/5555 
FESS ESSGSSEGSISISCSESSSGESSSSESEESCSSESGESESSSEGSSSSSEGSSECSESSSSSSSSO SINGS SSS SESES 


TIPTITNYTIIIIVVNNT TT TTT TTT TTT TTT ITT TTT tad dad SINGER Nlyaaaaaaa7 
BS RK RBBB RABE BOSH BREGKHRGKEKESHGHBHGKEKHBHBSSKEBHBE S| FRIDEN DIVISION - anata ee 


Figure 1-5. System Ten Source Card 


ASSEMBLER CODING FORM 


STATEMENT 0 ortinuation 


rand 
‘ 01 mn 
1 20 0 40 : 50 


SINGER 


FRIDEN DIVISION 


Figure 1-6.. Assembler Coding Form 
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INSTRUCTION ALIGNMENT 


Each machine instruction statement generates one instruction 
consisting of 10 characters. The assembler aligns each 
instruction so that when it is loaded, the leftmost character 
will have an address with a low order value of zero (as required 


by the hardware). This is sometimes referred to as tens 
boundary alignment. Adjacent instructions are aligned at 
adjacent tens boundaries. If the first of a series of 


instructions is preceded by a data field which does not 
terminate at a tens boundary, the instruction is aligned at the 
next higher tens boundary beyond the data field. If a machine 
instruction statement contains a label, a length of 10 is 
entered for that label in the label table. Index specification 
zero (indicating no indexing) is also entered. 


OPERATION FIELD KEYWORDS 


As with all assembler’ statements, the programmer writes a 
keyword in the operation field. There are thirteen keywords for 
machine instruction statements (corresponding to the thirteen 
machine instructions). For example, to assemble an Add 
instruction, the programmer writes "A" in the operation field; 
to assemble a Divide instruction, he writes "D", etc. 


The operation field Keyword determines the Op Code in the 
assembled instruction. It also determines the general operand 
form which the assembler will expect the programmer to use in 
writing his assembler’ statement. For example, the Add 
instruction always requires that the programmer use the "two 
length" form, while the Read instruction requires that’ the 
programmer use the “device/channel" form. 


Five instructions require the “two length" form, five require 
the "one length" form, two require the "“device/channel" form, 
and one requires the "branch variant" form. The assembler 
examines the operation field keyword before deciding which form 
to expect. Once the form is selected, the assembler proceeds to 
assemble the information supplied by the programmer, and to. 
supply missing information where permitted. For each form, the 
assembler knows what the programmer must supply and what he may 
omit. 


SYNTACTICAL ERRORS 


11-71 


An error listing is generated if there are deviations from the 
rules. In such a case the assembly iS terminated after. the 
label table has been listed. 
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OPERAND FORMS 


Assembler J 


The four 


INSTRUCTION NAME 


Add 

Divide 

Form Numeric 
Multiply 
subtract 


Compare 
Exchange 

Edit 

Move Character 
Move Numeric 


Read 
Write 
BRANCH 
Conditional 
Link 
service Request 
Unconditional 
Switch 
Legend: A,B 
C 
D 
IA,IB 
L 
LA,LB 
V 


operand 
are shown below. 


forms used in machine instruction statements 


FORM NAME 


OP CODE OPERAND FORM 
A(LA,IA),B(LB,IB)|Two-length 
| form 
A(L,IA),B(,IB) One-length 
form 
A(D,IA),B(C,1B) Device/ 
Channel 
form 
BC A(V),B(V) 
BC A(6),B(V) | 
BC ACT YS BLO? Branch 
BC A(5) form 
BC A(8) 


Address-A, Address/Count-B (range 0-9999) 
Channel and Control (range 
Input/Output Device (range 
Index Register Peaeiee O-3, O = no indexing) 
Length (range 1-100) 


Length (range 1-10) 


Branch Variant (range O-9) 
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1-71 


Operand Fields vs. Instruction Fields 


A, LA, IA, B, LB, IB in the above forms are the same symbols 
used in the Programmers Machine Reference Manual for identifying 
the fields of the internal instruction format: 


CHARACTER 0 1 2 3 4 5 6 7 8 9 {IBIT 


P| Ff | |acl i | ie jac 
ERR 
Pt tt ett 


EEE 


Whatever value the programmer indicates for A, LA, IA, B, LB, IB 
in his assembler statement will be assembled into the 
corresponding field of the internal instruction. D (device) is 
assembled into the LA field. C (channel) is assembled into’ the 
LB field. V (variant) is assembled into LA if its left 
bordering parenthesis adjoins A$; it is assembled into LB if its 
left bordering parenthesis adjoins B. 


mo wo fF a N 


Positional Aspects 


The operand field contains only positional parameters’) and 
punctuation marks (parenthesis, comma). The symbols used in 
this part to present the general operand forms are not keyword 
parameters. They are used merely to remind the programmer of 
what information is expected and how this information is 
assembled into the internal machine instruction: 


S A(LA,IA),B(LB,IB) 


The keyword "S" calls for the Subtract Op Code O111 and leads 
the assembler to expect the operand form _ shown. The form 
reminds the programmer to supply A and B (the addresses of 
Operand-A and Operand-B), LA and LB (the individual lengths of 
these operands), and the index register specifications, IA and 
IB (used for address modification). A typical statement might 
bes 


S 400(5,1),500(10,0) 


1-21 Assembler I 


© 1971, The Singer Company 


INTRODUCTION 


In this example, 400 is assembled into the internal A field, 5 
is assembled into the internal LA field, 1 is assembled into the 
internal IA field, etc. 


Internal Blanks 


LA,LB10 


L100 


The comma separating the left and right portions of the operand 
forms may be followed by trailing blanks (see figure 1-7). 


For instructions of the two length form, the programmer writes 
"10" when he wishes to specify a field length of 10 (he does not 
write OO). The assembler substitutes zero for 10 as required by 
the hardware in specifying a field length of 10. Thus, in the 
above example, the 10 causes the assembler to insert "0" into 
the internal LB instruction field. 


For the “one length" instructions where a field length of 100 is 
desired, the programmer writes "100" in the L position of the 
operand form. This causes the assembler to set zero into both 
the LA and LB fields of the internal machine instruction, thus 
conforming to the hardware convention for indicating a field 
length of 100. 


Operand Constants and Symbols 


Assembler I 


The operand parameters inside the parentheses must all be 
constants. The address parameters, A and/or BB, outside the 
parentheses must be one of the following: 


* 


- constant 


(flagged) constant 
(flagged) constant constant 


symbol 
Symbol constant 


The use of operand constants and symbols is shown in figure 1-8. 
The rules governing a flaggable constant address are: 


If the constant is not flagged and a COMMON statement is in 
effect, the common flag will be assembled into the internal 
machine instruction. 
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PAGE 0001 
SEQe LOCN 


0000 
0000 
0000 
0000 
0011 


0015 
5000 
5010 
5020 
5030 
5040 
5050 
5060 
5070 
5080 
5090 
5100 
5110 
5120 
9130 
5140 
5150 
5160 
5170 
5180 
5190 
5200 
5210 
5220 
5230 
9240 


5250 
5251 
5252 
5254 
5256 
5257 
5258 
5261 
5267 
5279 
5287 
5287 
5290 
S2egl 
5294 
5367 
5372 
5376 
5380 


5386 
5386 
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INSTR/DATA OP 


QU25040011 
1528710080 
S5SRUBN0000 
PUR873U258 
RSPPOQDQ0000 
QU2U035373 
SU2X73U376 
1UR5135376 
142904U376 
SU2Y14U367 
2UR 5235368 
4U3 W655 367 
TS5RROONDNN 
1U25655367 
P5261653R0 
PU367 45320 
P538065273 
052U730001 
052V710012 
1025440011 
PUR5420013 
RSPP055930 
052U730001 


.052Ww910008 


USRU800N00 


0*008 
ERA # 00-0 
OVERFLOW 


L 


MOONDRKP COC CDOOKFP FFEFNWRPKPWRPNOWH 


PROGRAM LISTING 


I B/S LI 


eooocccoococooorrocoroccocrF coc 
Or WON FY WOoOFRMOMWOF FWWWCWOrRr 
ooooccoocoocoocooo0o0dcccocecoo°oe 


Figure 1-7. 


LABEL 


OPCODE OPERAND(S) 


AND/OR COMMENTS 


* THIS EXAMPLE CALCULATES A BASEBALL PITCHER'S EARNED RUN AVERAGEs 
* THE INPUT IS FROM CARDS WITH UP TO TEN SETS OF DATA ON A CARD» 
* THE OUTPUT IS TO THE 


ERRWRT 


ZERO 
THREE 
TwOSEV 
EIGHT 
FIVE 
CR 
BLANKS 


DIVSOR 
ERA 


ORG 
DM 


ORG 


11 


N4 


5000 
ZERO, 
INPUT (1 )» 
BLANKS(3) 
IP» 
INIT( 2) 
ZEROs 

IPs 
THREE » 
FIP» 
RUNS» 
TWOSEVs 
DIVSORs 
ERRWRT({ 4) 
FIVEs 
EDITDMs 
QUOT( 4)» 
ERA» 
CR(0O)-s 
MSG(0)s 
EIGHTs 
EIGHT (2)» 
INIT(2) 9 
CR(0O)» 


WORKSTATION® 


XR1 *« ZEROS TO REGISTER 
80(1) * READ A CARD FROM THE READER 
* END JOB IF UNIT SEPERATOR® 
BLANKS * IS REST OF CARD BLANK? 
* YES» READ NEXT CARDe 
QUOT+6(3) * CLEAR OUT LAST 3 POSe OF DIVIDEND 
DIVSOR(3) * PUT IN LEFT MOST 3 POSITIONSe 
DIVSOR(3) * RESULT IS FOUR POSITIONSe 
DIVSOR * ADD TO RESULT 
QUOT(4) * LEADING ZERO ASSUREDe 
QUOT+1(3) * DIVIDEND IS Os 5S POSITIONSs AND 
QUOT * 3 TRAILING ZEROS FOR 3 DECIMAL PLACES 
CHECK FOR OQVERFLOWe 
QUOT ROUND OFF RESULT 
ERA MOVE IN EDIT MASK 
ERA PUT ANSWER IN WITH EDITING 
MSG+6 ANSWER TO MESSAGE 
1(3) CARRIAGE RETURN ON WORKSTATION. 
12 (1) WRITE ANSWER ON WORKSTATIONe 
XR1 TO GET NEXT SET OF DATA 
XR1+2 * HAS THERE BEEN 10 SETS OF DATA? 
LOOP(5) * YESsREAD CARDi NO» PROCESS DATAe 
1(3) * CARRIAGE RETURN ON WORKSTATION 


ERRMSG(0)28(1) * WRITE OVERFLOW MESSAGE ON WORKSTATION 


BLANKS(5) 


N'O! 
N'3) 
Niaz 
N'80t(4) 
NI5! 
CiMt 
c3' t 
C' O+0uer 


* END JOB 


C'ERA = 00-00 ! 


C'OVERFLOW! 
ocso 
N3(21) 
Ni(s1) 
N3(e1) 

C73 
N5 
N4 
N4 
C6 


INIT 
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INNINGS PITCHED 

FRACTIONAL INNINGS PITCHED#=0s1s0R 2: 
EARNED RUNS ALLOWED 

REMAINDER OF CARD IMAGE. 

ANSWER OF DIVIDE WILL BE 5 POSITIONS» 
DIVIDEND WILL INCLUDE THESE POSITIONS 


EARNED RUN AVERAGE 


Operands with Internal Blanks 
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If a "C" is appended to the constant, the corresponding 
common flag will be assembled into the internal machine 
instruction even though a NORMAL statement is in effect. 


Conversely, if a "P" is appended to the constant, the 
corresponding common flag will not be assembled into’ the 
internal machine instruction even though a COMMON statement 
may be in effect. 


Implied Operand Forms 


Assembler J 


The programmer is free to omit length parameters (LA, LB, L) and 
index parameters (IA, IB) from machine instruction statements, 
leaving it to the assembler to supply these values from the 
label table if the corresponding operand address is symbolic. 
If the operand address is a constant or *, the value supplied by 
the assembler for an omitted length parameter is 1, and _ the 
value supplied for an omitted index specification is 0. If L is 
omitted, the value supplied by the assembler is determined by A 
(and in no way depends upon B). Thus, if A is a constant and L 
is omitted, the assembler acts as though the programmer has 
written "“1" in the L position. If A is a symbol, the assembler 
Supplies the length from the label table entry corresponding to 
the symbol. 


It is not permissible to omit D (Device) or C (Channel) from the 


Read or Write instruction statement, nor is it permissible to 


omit V (Variant) from the Branch instruction. 


When a length parameter is omitted, and the index parameter is 
written, the comma which would have separated the two parameters 
is written adjacent to the left parenthesis and the index 
specification follows immediately with no intervening blanks: 


S ALFA(,1),BETA(,2) 


When a length parameter is written, and the index parameter is 
omitted, the comma which would have separated the two parameters 
is also omitted. The closing right parenthesis follows 
immediately after the length specifications: 


S ALFA(5),BETA(7) 
When both the length parameter and the index parameter are 
Omitted, the parenthesis and the comma internal to the 


parenthesis are also omitted: 


S ALFA,BETA 
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PAGE 0001 10/12/71 (4#02) PROGRAM LISTING FOR EXAMPLES OF OPERAND CONSTANTS AND SYMBOLS 


SEQ* LOCN INSTR/DATA OP A/R I LINE LABEL OPCODE OPERAND(S) AND/OR COMMENTS 


0000 0300 0002 300 

0300 PPS0010350 0300 0003 START ¥*»BRSW DOES FIRST POSITION OF BRSW2!P# 
0310 ROST050320 0340 0004 RESET(2)s¥*+10(5) YESs NO 

0320 P032010350 0320 0005 *sBRSWw PUT 'P* INTO FIRST POSITION 
0330 Uu0SU000000 0350 0006 t BRSW(5) 

0340 P04U810350 0458 0007 FIVEsBRSW MAKE BRANCH UNCONDITIONAL 
0350 U0SVv0571400 0360 0008 *#+410(5)2%4+50(5) FALLS THRU EVERY OTHER TIME 
0360 PPS6510459 0365 0009 *+55SW IS SW ONE? 

0370 ROSY050380 0390 0010 END(2)9¥*410(5) YES» NO 

0380 P038510459 0385 0011 *+5,SW PUT A ONE INTO Sw 

0390 1P39030455 0390 onte : #aCTR ADD ONE TO CTR 

0400 1PTP030455 0400 0013 ¥aCTR SUBTRACT ONE FROM CTR 

0410 2P45330455 0453 0014 NUM+2(2)sCTR ADD '34' TO CIR 

0420 P04553100P 0455 0015 CTR» 1000C MOVE CTR TO POS+ 1000 IN COMMON 
0430 P200P14900 2000C 0016 2000C »4000P COMMON ADRe TO PARTITION ADRe 
0440 Ud0TUOND000 0450 0917 STOP(S) 

0450 0001 0018 cree TO STOP RUN 

0451 1234 0001 0019 N4*1234! 

0455 O 0001 0020 N3'OQ! 

0458 5 0001 0021 N'St 

0459 0 0001 0022 N'O?t 

0460 0300 0023 =XKE START 

0460 0024 


OoonrraANnNouUdUonao 
coceoocoooocjocncc 
CORP WWWWr Fedde ceragar 
ooococoocooococ 


PAGE 0001 10/12/71 (4=02) LABEL TABLE FOR EXAMPLES OF OPERAND CONSTANTS AND SYMBOLS 
LABEL LOC LNTH INDX MESSAGES 


BRSW 0350 
CTR 0455 
END 0390 
FIVE 0458 
NUM 0451 
RESET 0340 
START 0300 
STOP 0450 
SW 0459 
9 LABELS 


ceooooo0o0o0ca 


Figure 1-8. Operand Constants and Symbols 
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INSTRUCTION FIELDS AND HOW THEY ARE GENERATED 


The preceding paragraphs, while they have dealt with the 
internal instruction fields, have been mainly concerned with the 
machine instruction assembler statements. The following 
paragraphs will be concerned with the instruction fields as such 
and how they are generated by the assembler. 


Fach ten-character instruction comprises nine fields in the 
format shown below: 


F, A, LA, IA, AC, B, LB, IB, BC 


For~ each machine instruction statement, the assembler generates 
one complete instruction. 


CHARACTER 0 1 2 3 4 5 6 7 8 9 | {BIT] 


F (Op Code) 


Assembier JI 


The operation field Keyword determines the Op Code. Invariably, 
"R", the keyword for Read, is assembled as O0O00, the Op Code for 
Read; "W", the keyword for Write, is assembled as.0O001, the Op 
Code for Writes; etc. 


OP CODE F INSTRUCTION NAME 
R Read 
W Write 
(Not Used) 
(Not Used) 
A Add 
D Divide 
M Multiply 
S) pubtract 
MC Move Character 
MN Move Numeric 
(Not Used) 
BC Branch 
E Edit 
FN Form Numeric 
C Compare 
x Exchange 
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A, B (Operand - Address/Count) 


Instruction fields <A and B are derived from assembler operand 


parameters A and B, respectively. 


If the operand parameter is a symbol, the address 
with the symbol in the label table is inserted 
instruction field. If the operand parameter is 
plus/minus a constant, the constant is used to adjust 


associated 
into the 
a symbol 
the value 


from the label table; the sum/difference is inserted into the 


instruction field. 


If the operand parameter is *, the address of the instruction 
being assembled is inserted into the instruction field. If the 
operand parameter is * plus/minus a constant, the constant is 
used to adjust the address of the current instruction; the 


sum/difference is inserted into the instruction field. 


If the operand parameter is a constant, the constant is inserted 
into the instruction field. If the operand parameter is a 
constant plus/minus a constant, the sum/difference is inserted 


into the instruction field. 


AC, BC (Common/Partition) 


Instruction fields AC and BC are determined by 
parameters A and B, respectively. 


If the assembler parameter A is symbolic, 


e.g. ALPHA 
ALPHA+100 


the AC field is set ON if the address represented by 
is in COMMON. Otherwise, AC is set OFF. 


If the assembler parameter A is *, 


e.g. * 
*4+100 


the AC field is set ON if a COMMON statement is 
Otherwise, AC is set OFF. 


If the assembler parameter A is an unflagged constant, 


e.g. 500 
500+10 


assembler 


the symbol 


in effect. 


the AC instruction field is set ON if a COMMON statement is in 


effect. Otherwise, AC is set OFF. 
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If the assembler parameter A is a constant flagged with a C, 


e.g. 500C 
500C+10 


the AC instruction field is set ON, unconditionally. 
If the assembler parameter A is a constant flagged with P, 


e.g. 500P 
500P+10 


the AC instruction field is set OFF, unconditionally. 


The above rules showing how AC is derived from A apply equally 
in showing the relation between B and BC. It is merely 
necessary for the reader to substitute "B" when he reads "A" and 
to substitute "BC" when he reads “AC". 


The COMMON statement is described in the section entitled 
Assembler Commands. 


IA, IB (Index Register Specification) 


Assembler I 


Instruction fields IA and IB are taken from assembler statement 
parameters IA and IB, providing these parameters are not 
omitted. If IA is omitted from the assembler statement, then 
the value of IA is supplied by the assembler. The value the 
assembler supplies depends upon assembler statement parameter A. 
A parallel relation holds between IB and B when IB is omitted 
from the assembler statement. Because of this parallelism, the 
rules will be presented only for IA. 


If IA is omitted from an assembler statement, and if A isa 
constant or *, then instruction field IA is set to O (indicating 
no indexing). 


If IA is omitted from an assembler statement, and if A isa 
symbol for the address of an instruction, then instruction field 
IA is set to O (indicating no indexing). 


If IA is omitted from an assembler statement, and if A isa 
symbol for the address of a data field, then instruction field 
IA is taken from the label table index entry for that symbol. 
The establishment of a data field index entry in the label table 
is part of the function of the Define Memory Statement 
(described in the section entitled Assembler Commands). 
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INTRODUCTION 


LA, LB (Length, Device, Channel, Variant) 


For the "“device/channel" form, instruction field LA is taken 
from D, and instruction field LB is taken from C. 


For the "branch" form, instruction field LA is taken from the 
value of V in the parenthesis adjacent to assembler statement 
parameter A. LB is taken from the value of V in the parenthesis 
adjacent to assembler statement parameter B. 


For the two length form, instruction field LA is taken from the 
value of LA in the assembler statement. If assembler parameter 
LA=10, it is assembled as O. In similar fashion, instruction 
field LB is taken from assembler statement parameter LB. If LA 
or LB are omitted, the assembler supplies the values for the 
omitted parameters as described under “Implied Forms", above. 


For the one length form, both instruction fields LA and LB are 
taken from assembler parameter L. LA is set to the tens digit 
of L, and LB is set to the units digit of L. If L=100, both LA 
and LB are set to O. If L is omitted, the assembler supplies a 
value for it as described under “Implied Forms", above. 


ASSEMBLER COMMANDS 


1-71 


Unlike the machine instruction statements, the assembler 
commands do not generate executable code. The primary purpose 
is to control the assembly. An exception to this is the DM 
(Define Memory) statement which also permits the programmer. to 
specify data to be loaded with the program. 


Listing Control Commands 


TITLE establishes the title line text of the assembly listing. 
| This line is printed at the top of each page. 


DFACH generates blank lines in the assembly listing, thus 
enabling the programmer to make his listing more easily 


readable. 


EJECT advances the assembly listing to the next page. 
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INTRODUCTION 


Address Control Commands 


ORG 


NORMAL 


COMMON 


sets the value for the next address to be assigned by 
the assembler. 


causes the assembler to start assigning addresses in 
partition. 


causes the assembler to start assigning addresses in 
common. 


Termination Control Commands 


Memory Allocation 


Assembler J 


EXEC 


END 


DM 


generates an 5S (start) card in the object code. The §S 
card will be interpreted during loading. It causes’7~ the 
loader to stop loading and to begin execution at the 
address specified by the programmer. For source 
programs containing several overlays, the final 
statement in each overlay is an EXEC statement. 


Shows the end of the source program and is thus the last 
statement in it. Each source program, even if it 
contains several overlays, may contain but one END 
statement. 


Commands 


defines memory data fields and generates initial data. 
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Section 2 
MACHINE INSTRUCTION STATEMENTS 


INTRODUCTION 

ADD 

BRANCH (Conditional, Unconditional, Switch) 
BRANCH AND LINK 

BRANCH ON SERVICE REQUEST 
COMPARE 

DIVIDE 

EDIT 

EXCHANGE 

FORM NUMERIC 

MOVE CHARACTER 

MOVE NUMERIC 

MULTIPLY 

READ 

SUBTRACT 

WRITE 


MACHINE INSTRUCTION STATEMENTS 


INTRODUCTION 


1-71 


This section details the information related to the machine 
instruction statements, including information about their 
execution. After the introduction, the page headings are 
arranged in alphabetical order for ease of reference: 


ADD 

BRANCH (Conditional, Unconditional, Switch) 
BRANCH AND LINK 

BRANCH ON SERVICE REQUEST 
COMPARE 

DIVIDE 

EDIT 

EXCHANGE 

FORM NUMERIC 

MOVE CHARACTER 

MOVE NUMERIC 

MULTIPLY 

READ 

SUBTRACT 

WRITE 


The range shown in the assembler statements (0-9999) is usually 


represented symbolically when defined as a label in an assembler 
statement. 
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MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 


Operation Mnemonic 
A 


Operand Form 


A(LA,IA),B(LB,IB) Two-length form 
Legend 
PARAMETER RANGE REQ/OPT DESCRIPTION 
REQUIRED | Address of Operand-A 
LA Optional | Length of Operand-A 
IA Optional | Index Register for A 
B REQUIRED | Address of Operand-B and Sum 
LB Optional | Length of Operand-B and Sum 
IB Optional | Index Register for B 
Notes 
For a discussion of the values supplied by the assembler when 
the programmer omits an optional parameter from the operand 
specification, see Section 1, under "Implied Operand Forms." 
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MACHINE INSTRUCTION STATEMENTS 


EXECUTION 
Effect 
The Add instruction (Op Code 0100) adds the numeric portions of 
Operand-A and Operand-B algebraically. The sum replaces 
Operand-B. 
Details 


The add operation proceeds from right to left starting with the 
rightmost characters of Operand-A and Operand-B. Character by 
character, the algebraic sum is developed in Operand-B. 


If Operand-A is shorter than Operand-B, the operation proceeds 
normally until Operand-A is exhausted. After that, the process 
continues in similar fashion except that a zero character is 
automatically substituted every time the adding logic calls for 
a character from Operand-A. In effect, Operand-A is given 
enough preceding zeros to make it the same length as Operand-B. 


If Operand-A is longer than Operand-B, addition stops after the 
leftmost position in Operand-B has been added. The remaining 
positions in Operand-A are ignored, and do not affect the sum or 
the Condition Code. 


The algebraic sign of the sum is. placed in bit-7 of the 
rightmost position of Operand-B, and bit-5 is turned ON. Except 
for the rightmost character, the other zone bits of Operand-B 
are unchanged. Operand-A is unchanged by the add Operation. 


If the sum exceeds the capacity of Operand-B, a carry-to-the- 
left from the leftmost position does not occur. Condition Code 


4 is set to indicate the overflow. 


The instruction A *,FIELD will addl1 to the contents of the 
label FIELD. 


Condition Codes 


After completion of the Add instructions: 


1 = Negative, non-zero sum. 
2 = Zero sum. 
3 = Positive, non-zero sum. 
4 = Overflow. 
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MACHINE INSTRUCTION STATEMENTS 


BRANCH INSTRUCTION 


The Branch instruction (Op Code 1011) permits departure from the 
sequential path by which instructions are normally executed. 
Branching can be unconditional, it can depend upon the current 
status of the Condition Code, or it can depend upon signals from 
Input/Output devices requesting service from the CPU. A variant 
of the Branch instruction passes control to a subroutine after 
first setting the return address at which the main program will 
be resumed. Execution of the Branch instruction does not alter 
the Condition Code. 


Order of Presentation 


Partition 


Assembler J 


The Branch instruction consists of several variants. The LA and 
LB instruction fields determine which variant is executed. 
"Link" (variant 6) and "Branch on Service Request" (variant 7) 
require that the entire instruction be decoded. These variants 
are discussed later under separate headings. The other variants 
are decoded and executed a half instruction at a time and are 
most conveniently discussed aS a group. 


Switching 


If a Branch instruction does not require a branch, execution 
Simply continues with the next sequential instruction. 


If the host partition has been in continuous control for more 
than 37.5 milliseconds when a branch is required, the branch is 
taken but the execution of the instruction at the branch address 


is postponed and control passes to the next partition. When 
control returns, execution resumes at the branch address. If 
the branch is caused by variant 8 ("Branch and switch, 


unconditionally"), the branch is taken but the execution of the 
instruction at the branch address is postponed and control 
passes to the next partition even though 37.5 milliseconds have 
not elapsed. 


2-4 11-71 


© 1971, The Singer Company 


MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 


Operation Mnemonic 
BC 


Operand Form 


A(V),B(V) Branch-Conditional form 
A(5) Unconditional-branch form 
A(8) Unconditional-switch-and-branch form 
Legend 
PARAMETER RANGE REQ/OPT DESCRIPTION 
REQUIRED | First branch address 
V REQUIRED | Variant 
B OPTIONAL | Second branch address 
NOTE: If B is used, it must be in the form B(V). 
EXECUTION 


Variants O, 1, 2, 3, 4, 5, 8, 9 


The first five characters of the instruction are fetched. LA is 
examined. If a branch is required, control passes to Address-A, 
and the right half of the instruction is ignored. If a branch 
is not required in the left half of the instruction, the right 
half is fetched. LB is examined. If a branch is required, 
control passes to Address-B. If a branch is not required, 
execution continues with the next sequential instruction. 
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MACHINE INSTRUCTION STATEMENTS 


The following table shows the values which V (and thus LA and 
LB) may assume. Beside each variant number is the meaning 
applied by the ACU. Variant 6 and variant 7 are purposely 
omitted. They are discussed under "Branch and Link" and "Branch 
on Service Request." 

Variant O---Do not branch ("no operation"). 

Variant 1---Branch if Condition Code is l. 

Variant 2---Branch if Condition Code is 2. 

Variant 3---Branch if Condition Code is 3. 

Variant 4---Branch if Condition Code is 4. 

Variant 5---Branch, unconditionally. 


Variant 8---Branch and switch partitions, unconditionally. 


Variant 9---Do not branch ("no operation"). 


Condition Code 


Assembler I 


The Branch instruction does not alter the Condition Code. 
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MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 
Operation Mnemonic 
BC 


Operand Form 


A(6),B(V) Branch-and-link form 
Legend 
PARAMETER RANGE REQ/OPT DESCRIPTION 
REQUIRED | Return address 
V 0-5,8,9)/ REQUIRED | Variant 
B REQUIRED ; Start address 
Notes 
"6" is assembled into the LA instruction field. 
V may assume the following values: 
O---No branch and no link. 
1---Branch and link if Condition Code is l. 
2---Branch and link if Condition Code is 2. 
3---Branch and link if Condition Code is 3. 
4---Branch and link if Condition Code is 4. 
5---Branch and link, unconditionally. 
~8---Switch,branch, and link, unconditionally. 
9---No branch and no link. 
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~ MACHINE INSTRUCTION STATEMENTS 


EXECUTION 


Effect 


If V (thus LB) is O or 9, no link occurs$; control simply passes 
to the next instruction. 


If V (thus ULB) is 1-4, the corresponding Condition Code is 
tested. If the specified Condition Code is ON, the link 
operation is performed. Otherwise, control simply passes to the 
next instruction. 


If V (thus LB) is 5 or 8, the link operation is performed, 
unconditionally. 


Return Address/Start Address 


The address of the next instruction (return address) is inserted 
into the numerical portion of the four position field starting 
at Address-A. The zone portions of the three left character 
positions are unchanged. Bit 5 of the rightmost position is set 
to 1. Bit-7 is set to 1 if the return address is in common; it 
is set to O if the return address is in partition. Control then 
passes to Address~-B (start address). 


Condition Code 


Assembler J 


Branch and Link does not alter the Condition Code. 
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MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 


Operation Mnemonic 
BC 
Operand Form 
A(7),B(0O) Branch-on-service-request form 


Legend 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Save address for device number 


REQUIRED | Branch address 


EXECUTION 
Effect 


Fach I0C continually polls the input/output devices attached to 
it to see if a device has signalled a request for service. If 
the IOC encounters such a signal, further polling for service 
requests is temporarily discontinued, and the device number is 
held in a counter until the CPU executes "Branch on Service 
Request." 


Storing Device Number 


"Branch on Service Request" causes the counter to be stored in 
the numeric portion of the character position pointed to by 
Address-A. Control then passes to Address-B. Polling resumes 
with the next higher device number (or 0, if the requesting 
device was 9). 


If the I0C is holding no such request for service, “Branch on 
service Request" has no effect. Execution continues with the 
next sequential instruction. 


Condition Code 


Branch on Service Request does not alter the Condition Code. 
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MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 


Operation Mnemonic 


C 


Operand Form 


Legend 


Notes 


Assembler J 


A(L,IA),B(,1B) One-length form 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Address of Operand-A 


L Optional | Length of Operand-A and 
Operand-B 

IA Optional | Index Register for A 

B REQUIRED | Address of Operand-B 

IB Optional |} Index Register for B 


Instruction field LA is set to the tens digit of L, and 
instruction field LB is set to the units digit of L. If L=100 , 
both LA and LB are set to O. If L is omitted, the assembler 
supplies a value for it. To this value, the above rule holds. 


For a discussion of values supplied by the assembler when the 
programmer omits an optional parameter from the operand 
specification, see Section 1, under "Implied Operand Forms." 
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MACHINE INSTRUCTION STATEMENTS 


EXECUTION 
Effect 


The Compare instruction (Op Code 1110) compares two fields and 
sets the Condition Code to indicate the relation between then. 
(This comparison is based upon the bit configurations for the 
System Ten character set as shown in figure 2-1.) 


Details 


The compare operation proceeds from left to right starting with 
the leftmost character of Operand-A and Operand-B. Character by 
character, the values of Operand-A and Operand-B are compared 
until a difference is found or the rightmost position has’ been 
compared. 


When the characters differ, Condition Code l, or 3 and 4 is set 
ON (indicating that Operand-A is smaller or larger than Operand- 
B), and the operation is complete. 


If the characters are identical, and there are more positions to 
be compared, the comparison is repeated for the next position on 
the right. 


When the characters are identical and there are no more 
positions to be compared, Condition Codes 2 and 4 are set ON. 


Operand-A and Operand-B are unchanged by the compare operation. 


When Condition Code 3 or 2 is set ON, Condition 4 is also set 
ON. 


Condition Codes 
1, if Operand-A is less than Operand B. 


2 and 4, if Operand-A and Operand-B are identical. 
3 and 4, if Operand-A is greater than Operand-B. 
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System Ten Character Set 


Figure 2-1. 
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Assembler IJ 


MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 


11-71 


Operation Mnemonic 


D 


Operand Form 


Legend 


Notes 


A(LA,IA),B(LB,IB) Two-length form 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Address of Operand-A, the 


divisor 


LA Optional | Length of divisor 
TA Optional | Index Register for A 
B REQUIRED | Address of Operand-B, the 
dividend and the quotient 
LB Optional | Length of quotient 
IB Optional | Index Register for B 


For a discussion of the values supplied by the assembler when 
the programmer omits an optional parameter from the operand 
specifications, see Section 1, under “Implied Operand Forms." 
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MACHINE INSTRUCTION STATEMENTS 


EXECUTION 
Effect 


The Divide instruction (op Code 0101) computes the algebraic 
quotient (and remainder) of two operands. 


Details 
Operand-A is the divisor. 


The dividend begins at the B address and contains LB + LA 
positions. 


At the end of the operation, the quotient occupies the leftmost 
LB positions of the dividend field, and the remainder occupies 
the rightmost LA positions of the dividend field. 


If the divisor and the dividend differ in sign, bit-7 of the 
quotient is turned ON to indicate a negative quotient. If the 
Signs are alike, pbit-7 is turned OFF to indicate a positive 
quotient. Bit-5 is turned ON for all positions of the quotient; 
bit-7 is turned OFF for all positions of the quotient field 
except the rightmost. 


Bit-7 of the rightmost position of the remainder is unchanged. 
It continues to show the sign of the dividend. Bit-5 is set’ to 
1. The zone bits of the other positions in the remainder are 
unchanged. 


Division by Zero 


An attempt to divide by zero causes Condition Code 4 to be set 
(indicating overflow). The value of the dividend is unchanged. 


Preventing Overflow 


Overflow will only occur if the absolute value in the leftmost 
LA positions of the dividend equals or exceeds the absolute 
value of the divisor. In cases where it is necessary to 
accommodate the widest possible range of data, including 
division by 1, the leftmost LA positions of the dividend should 
contain zero. 


Condition Codes 


After completion of the Divide instruction: 


1 = Negative, non-zero quotient. 
2 = Zero quotient. 
5 = Positive, non-zero quotient. 
4 = Overflow. 
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MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 


Operation Mnemonic 
E 


Operand Form 


Alli, TA). B58) One-length form 
Legend 
PARAMETER RANGE REQ/OPT DESCRIPTION 
REQUIRED | Address of Operand-A 
L Optional | Length of Operand-A 
IA Optional | Index Register for A 
B REQUIRED | Address of Operand-B, the 
control field 
IB Optional | Index Register for B 
Notes 
Instruction field LA is set to the tens digit of L, and 
instruction field LB is set to the units digit of L. If L=100, 
both LA and LB are set to 0. If L is omitted, the assembler 
Supplies a value for it. To this value, the above rule holds. 
For a discussion of values supplied by the assembler when the 
programmer omits an optional parameter from the operand 
specification, see Section 1, under "Implied Operand Forms." 
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MACHINE INSTRUCTION STATEMENTS 
EXECUTION 
Effect 
The Edit instruction (Op Code 1100) moves a 1-100 digit 
numerical field into a "control" field so that the information 
is in a form suitable for printing. The control field governs 
the suppression of preceding zeros (including the insertion of 
check protection characters ahead of significant digits), the 
insertion of punctuation marks, and the indication of sign. 
Details 


Assembler I 


The Edit instruction begins by extracting the leftmost digit of 
Operand-A and by finding the leftmost filler character in the 
control field. During the hunt for the filler character, any 
intervening @ sign in the control field is replaced by a blank 
character, and any intervening punctuation mark is replaced by 
the neighboring character on the left. 


If the Operand-A digit is significant, the numeric portion is 
put into the filler position of the control field, and the zone 
bits of that position are set to O/1l to insure that the position 
will print as a numerical value. 


If the digit is non-significant zero, but the filler character 
is O, the digit is stored in the filler position as a 
Significant zero (as are any to the right of it in Operand-A). 


If the digit is non-significant, the filler character is left 
undisturbed. 


The process is repeated using the next digit to the right in 
Operand-A and the next filler character in the control field. 
Once a Significant digit has been moved from Operand-A into the 
control field, any punctuation mark to the right of it is 
allowed to. stand and is not replaced by its left-hand neighbor. 


The process continues until the rightmost digit in Operand-A and 
the rightmost filler character of the control field have been 
dealt with. The Condition Code is set. If Operand-A contains a 
positive value or zero, a blank character is set in the sign 
position of the control field (the position just to the right of 
the rightmost filler character). 
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MACHINE INSTRUCTION STATEMENTS 


Condition Codes 


After completion of the Edit instruction. 


1 = Negative, non-zero Operand-A. 
2 = Zero Operand-A. 
5 = Positive, non-zero Operand-A. 


An overflow condition is not possible. 
Control Field (Operand-B) 


A filler character is defined as any character other than the @ 
Sign or a punctuation mark (comma, decimal point, hyphen, 
Slash). 


Minimally, a control field consists of as many filler characters 
as there are digits in Operand-A plus one trailing character. to 
Show sign. In addition, the filler characters may be freely 
interspersed with punctuation characters (comma, period, hyphen, 
Slash) and @ signs. 


Since the Edit instruction destroys the control field, the 
programmer normally moves the control field to the Operand-B 


address before each use of the Edit instruction. 


The filler characters designate the control field positions into 


which Operand-A digits can be moved. Significant digits from 
Operand-A simply replace the corresponding filler positions in 
the control field. Filler characters corresponding to non- 


Significant zeros in Operand-A are not replaced, they are 
undisturbed. This permits the suppression of preceding zeros 
(leCe5 the filler positions are preset to contain blank 
characters) or the use of check protection characters ahead of 
Significant digits (i.e., the filler positions are preset to 
contain a protect character such as asterisk). 


The punctuation characters are used to punctuate the significant 
information received from Operand-A. At the completion of the 
Edit instruction, any punctuation characters which find 
themselves embedded in the significant portion of the control 
field remain undisturbed by the operation and thus show the 
desired punctuation. Any punctuation character to the left of 
the significant portion of the control field will have been 
replaced by the neighboring character on the left and thus wiped 
out. A control field should not begin with a punctuation 
character. 


The @ sign is used to insert blank characters between filler 
positions. Execution of the Edit instruction replaces each @ 
Sign in the control field with a blank character. 
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MACHINE INSTRUCTION STATEMENTS 


The rightmost position of the control field is used to show the 
Sign of Operand-A. Ordinarily, the programmer presets’7 the 
position to contain a hyphen or some other character to indicate 
minus. If Operand-A is negative, the minus character remains. 
If Operand-A is zero or positive, the minus character is 
overwritten with a blank character. 


Edit Instruction Examples 


Printing Social Security Numbers 


Operand-A 098144159 
Operand-B 000-00-0000- before editing 
Operand-B 098-14-4159 after editing 


Check Protection 


Operand-A 0000001234 
Operand-B ee ee Ors before editing 
Operand-B en ae RE Lo after editing 


Use of Commas 


Operand-A 1234567890 
Operand-B bb,bbb,bbb.O00- before editing 
Operand-B 12,345,678.90 after editing 
Note---b is here used to represent a blank character. 


Suppressing Preceding Zeros 


Operand-A 0000012345 
Operand-B bb,bbb,bbb.O0- before editing 
Operand-B bbbbbbb1l23.45 after editing 
Note---b is here used to represent a blank character. 
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ASSEMBLER STATEMENT 


1-71 


Operation Mnemonic 


xX 


Operand Form 


Legend 


Notes 


A(L,IA),B(,IB) One-length form 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Address of Operand-A 


L Optional | Length of Operand-A and 
Operand-B 

IA Optional | Index Register for A 

B REQUIRED | Address of Operand-B 

IB Optional | Index Register for B 


Instruction field LA is set to the tens digit of L, and 
instruction field LB is set to the units digit of L. If lL=100, 
both LA and LB are set to 0. If L is omitted, the assembler 
supplies a value for it. To this value, the above rule holds. 


For a discussion of values supplied by the assembler when the 


programmer omits an optional parameter from the operand 
specification, see Section 1, under “Implied Operand Forms." 
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EXECUTION 


Effect 


The Exchange instruction (Op Code 1111) interchanges’ the 
characters in two fields of equal length. Each field can 
comprise 1-100 characters. 


Details 


The leftmost character of Operand-B is extracted and held 
temporarily in a register. The character in the leftmost 
position of Operand-A is moved to the leftmost position in 
Operand-B, and the character in the register is then stored in 
the leftmost position of Operand-A. This operation is repeated 
from left to right until the entire fields have been 
interchanged. 


Condition Code 


iae after completion of the Exchange instruction. 
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MACHINE INSTRUCTION STATEMENTS 


ASSEMBLER STATEMENT 
Operation Mnemonic 
FN 
Operand Form 
A(LA,IA),B(LB,IB) Two-length form 


Legend 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED 


Address of Operand-A 


LA Optional | Length of Operand-A 

IA Optional | Index Register for A 

B REQUIRED | Address of Operand-B 

LB Optional | Length of Operand-B 

IB Optional | Index Register for B 

Notes 

For a discussion of values supplied by the assembler when the 

programmer omits an optional parameter from the operand 

specification, see Section 1, under "Implied Operand Forms." 

EXECUTION 
Effect 

The Form Numeric instruction (Op Code 1101) moves numeric 

information from a 1-10 position mixed field to a second 1-10 

position field. After the operation, the second field is of the 

numerical form normally used for arithmetic operations. 

Details 

Execution begins with a right-to-left search for the rightmost 

digit in Operand-A and a determination of its sign: 
If the rightmost non-blank character is a digit (0-9), 
it is moved unchanged into the rightmost position of 
Operand-B. The sign of Operand-B is positive. 
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If the rightmost non-blank character is one of the 
characters P thru Y, it is considered to be a digit with 
a minus sign. It is moved unchanged into the rightmost 
position of Operand-B. The sign of Operand-B is 
negative. 


If the rightmost non-blank character is a hyphen (minus 
Sign), the rightmost digit is converted to the 
corresponding character P thru Y (i.e., bit=7 is set ON) 
and is stored in the rightmost position of Operand-B. 
The sign of Operand-B is negative. 


If the rightmost non-blank character is none of the 
above, it is skipped over and the rightmost digit is 
moved unchanged into the rightmost position of Operand- 
B. The sign of Operand-B is positive. 


Once the rightmost digit is selected from Operand-A and is moved 
into Operand-B, the process continues from right to left. The 
next digit to the left is found in Operand-A and is moved 
unchanged into the next left position of Operand-B. Intervening 
characters which are not digits are simply passed over and are 
not moved. 


If a digit is moved into the leftmost position of Operand-B and 
there are yet unmoved digits in Operand-A, the operation is 
abandoned and Condition Code 4 is set to show the overflow 
condition. 


When the leftmost digit of Operand-A is moved into an Operand-B 
position, any unfilled positions in Operand-B are set to zero 
and the operation is finished. 


If Operand-A consists entirely of blank characters, no digits 
can be moved. In this case, Operand-B is set to zero in all 
positions. 


Condition Codes 


Assembler J 


After completion of the Form Numeric instructions 


Negative, non-zero Operand-B. 
Zero Operand-B. 

Positive, non-zero Operand-B. 
Overflow. 


m Wd 
tol 


lI 
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ASSEMBLER STATEMENT 
Operation Mnemonic 
MC 
Operand Form 
A(L,IA),B(,1B) One-length form 


Legend 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Address of Operand-A 


L Optional | Length of Operand-A and 
Operand-B 

IA Optional | Index Register for A 
B REQUIRED |} Address of Operand-B 
IB Optional | Index Register for B 

Notes 
Instruction field LA is set to the tens digit of L, and 
instruction field LB is set to the units digit of L. If L=100, 
both LA and LB are set to O. If L is omitted, the assembler 
supplies a value for it. To this value, the above rule holds. 
For a discussion of values supplied by the assembler when the 
programmer omits an optional parameter from the operand 
specification, see Section 1, under “Implied Operand Forms." 

EXECUTION 

Effect 
The Move Character instruction (Op Code 1000) moves a field 
containing 1-100 characters from one location in memory to 
another. 

Details 


Operand-A is copied into Operand-B, one character at a time, 
starting with the leftmost character, and proceeding from left 
to right. 

Condition Code 


2, after completion of Move Character instruction. 
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ASSEMBLER STATEMENT 
Operation Mnemonic 
MN 
Operand Form 
A(L,IA),B(,IB) One-length form 
Legend 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Address of Operand-A 


L Optional | Length of Operand-A and 
Operand-B 

IA Optional | Index Register for A 
B REQUIRED | Address of Operand-B 
IB Optional | Index Register for B 

Notes 
Instruction field LA is set to the tens digit of L, and 
instruction field LB is set to the units digit of L. If lh=100, 
both LA and LB are set to O. If L is omitted, the assembler 
Supplies a value for it. To this value, the above rule holds. 
For a discussion of values supplied by the assembler when the 
programmer omits an optional parameter from the operand 
specification, see Section 1, under "Implied Operand Forms." 

EXECUTION 

Effect 
The Move Numeric instruction (Op Code 1001) moves the numeric 
portion of a field containing 1-100 characters from one location 
in memory to another. 

Details 


The numeric portion of Operand-A is copied into Operand-B. The 
operation proceeds one digit at a time, starting with the 
leftmost digit and proceeding from left to right. The zone bits 
of Operand-B are undisturbed. 


Condition Code 


2, after completion of Move Numeric instruction. 
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ASSEMBLER STATEMENT 


1-71 


Operand Mnemonic 


M 


Operand Form 


Legend 


Notes 


A(LA,IA) ,B(LB,IB) Two-length form 


PARAMETER RANGE REQ/OPT DESCRIPTION 


REQUIRED | Address of Operand-A, 


the multiplicand 


LA Optional |} Length of multiplicand 

IA Optional } Index Register for A 

B REQUIRED | Address of Operand-B, the 
multiplier and product 

LB Optional | Length of multiplier 

IB Optional | Index Register for B 


For a discussion of the values supplied by the assembler when 
the programmer omits an optional parameter from the operand 
specification, see Section 1, under “Implied Operand Forms." 
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EXECUTION | 


Effect 


The Multiply instruction (Op Code 0110) computes the algebraic 
product of two 1 to 10 position numeric operands. 


Details 
Operand-A is the multiplicand. 
Operand-B is the multiplier. 
The product is developed in a field of length LA+LB starting at. 
the Operand-B address. The product field may be thought of as 
consisting of two fields: the multiplier and a rightward 
extension with a length equal to that of the multiplicand. 
If the factors differ in sign, bit-7 of the rightmost positions | 
of the product is turned ON. If the signs are alike, pbit-7 is 
turned OFF. Bit-5 is turned ON for all positions of the 


product. Bit-7 is always turned OFF for all positions of the 
product except the rightmost. 


Condition Codes 


After completion of the Multiply instructions: 


1 = Negative, non-zero product. 
2 = Zero product. 
5 = Positive, non-zero product. 
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ASSEMBLER STATEMENT 


Operation Mnemonic 
R 


Operand Form 


A(D,IA),B(C,IB) Device/Channel form 
Legend 
PARAMETER RANGE REQ/OPT DESCRIPTION 
REQUIRED | Address of input area 
D REQUIRED |} Device number 
IA Optional | Index Register for A 
B REQUIRED | Count or indirect disc 
address (must be a numeric 
value) 
C REQUIRED | Channel and Control 
IB Optional } Index Register for B 
Notes 


For a discussion of the values supplied by the assembler when 

the programmer omits an optional parameter from the operand 

specification, see Section 1 under "Implied Operand Forms." 
Channel Specification 

O. FAC, File Access Channel. 


Te IoC, Input Output Channel, fill mode. 


Bs IOC, Input Output Channel, non-fill mode. 
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Device Specification 


Ioc devices are interchangeable in device number. Most 


installations prefer a standard setup. FAC device numbers” are 


STANDARD DEVICE NUMBERS 


IOC FAC 
O Workstation | Dise Controller 
1 Card Reader Magnetic Tape Drive l 
2 Line Printer Magnetic Tape Drive 2 


5 Paper Tape Reader Magnetic Tape Drive 3 


4 Card Punch Magnetic Tape Drive 4 


6 Paper Tape Punch = 


7 = = 
&: <= On Line Communications Adapter 
9 _ es 
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Disc Address 


B is the character count for any device except the disc 
controller. For the dise controller, the count is always 100. 
To select the dise controller, the programmer makes both D and C 
(Device and Channel) equal to zero. When the disc is’ thus 
specified, B becomes the indirect disc address, pointing to the 
6 character dise address field. The format of the disc address 
field iss: 


In the above representation, the zone bits are not shown. Bit-d 
must be ON. Bit-7 is ignored. 


As Device number (0-9). 

Bs: Arm number (0-4). 

C: Hundreds digit (O or 1) of a three-digit track number. 
D: Tens digit (0-9) of a three-digit track number. 

E: Units digit (O-9) of a three-digit track number. 

F: Tens digit (0-9) of a two-digit sector number. 


G: Units digit (0-9) of a two-digit sector number. 
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EXECUTION 


Effect 


The Read instruction (Op Code 0000) moves data from an input 
device to sequential locations in Main Memory. 


IOC General Operation 


A Read instruction that specifies data transmission through the 
IoC is executed incrementally. The instruction is first 
decoded, and parameters are set into registers A, B, and P for 
that partition initiating the operation. A signal is sent to 
the IOC to alert the input device. Control is then relinquished 
to the next partition. The fulfillment of the read instruction 
is performed between the execution of instructions in the other 
partitions. Before each instruction begins, the CPU stores”7 one 
character for each I0C that has a character ready. This 
incremental operation proceeds as follows: | 


1. An IOC requests a character from the input device. 


ae The input device gives a character to the IOC which sets 
a Signal to inform the CPU of “character ready." 


5. Between instruction executions, the CPU discovers the 
Signal, stores the character being held by the IOC, and 
updates the parameter registers. 


A. If the number of characters already transmitted has 
reached the count specified in the Read instruction, no 
more characters are requested. If the count has not 
been reached, steps 1, 2, 3, and 4 are repeated. 


If control returns to the partition which initiated the Read 
instruction before the count is satisfied, control simply passes 
to the next partition. If the count is satisfied when control 
returns to the partition which initiated the Read instruction, a 
Condition Code is set (see description of individual devices), 
and execution continues with the next sequential instruction 
following the Read instruction. 


FAC General Operation 


Assembler I 


A Read instruction that specifies data transmission through the 
FAC does not relinquish control to the next partition during 
data transmission. Instead, the CPU is devoted exclusively to 
storing data provided by the FAC until the entire count is 
satisfied. During this period the CPU does not service any IOC. 
service to the IOCS resumes at the completion of the Read 
instruction. 
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1-71 


Disc Access Sequence 


Fill 


A Read instruction addressing the disc does not typically pre- 
empt the CPU (as described above) immediately. It is sometimes 
necessary to wait until the dise is free, and then to wait while 
the heads move to the required cylinder. During either type of 
wait, control passes to the neighboring partition, and returns 
again in normal sequence. 


A dise is free if it is not bound to another partition. It is 
bound to a given partition as soon as the partition institutes a 
seek upon it3 it remains bound until data transmission is 
complete. 


If the dise is bound to another partition when a Read 
instruction is attempted, control merely passes to the next 
partition. The Read instruction will be attempted again when 


control returns to the host partition. 


If the disc is free when a Read instruction is attempted, a seek 
is automatically instituted, and the disc is then bound to the 
host partition. If head movement is necessary, control passes 
to the next partition. Transmission begins when the heads reach 
the proper cylinder, when control returns to the host partition, 
and when the desired sector rotates into place. 


If the heads are already "on cylinder" when the seek is 
instituted, control remains with the host partition. 
Transmission begins as soon as the desired sector rotates into 
place. 


When the disc record is entirely transmitted, a Condition Code 
is set to indicate the outcome. The CPU services any 
outstanding I0C for signals, and execution continues with the 
next sequential instruction following the Read instruction. 


Succeeding instructions in the host partition which access the 
same cylinder will be executed without switching partitions. 
The first attempt to access another cylinder, however, will free 
the disc and pass control to the next partition. When control 
again returns to the host partition, the Read/Write instruction 
will be subject to the entire wait process (as described above). 


and WNon-Fill 


A Read instruction using the IOC will terminate prematurely if 
the input device sends the IOC a Unit Separator character. In 
such a case, the Unit Separator character is not stored. 
Remaining positions of the input area are normally filled with 
blank characters. If the non-fill option was requested (bit-4 
of instruction field LB), the remaining positions in the input 
area are left undisturbed. 
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Condition Codes 


After completion of the Read instruction: 


l1 = Error 
2 = Normal 
53 = Flag 

4 = Fault 


For more information on Condition Codes and their meaning for 
particular devices, the reader is referred to Appendix F, "1/0 
Device Condition Codes.” 
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ASSEMBLER STATEMENT 
Operation Mnemonic 
S 
Operand Form 
A(LA,IA),B(LB,IB) 
Legend 


PARAMETER RANGE 


LA 


IA 


LB 


IB 


Notes 


For a discussion 


the programmer omits an 


specification, see 
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Two-length form 


DESCRIPTION 


REQ/OPT 


REQUIRED |} Address of Operand-A 


(the subtrahend ) 


Optional | Length of Operand-A 


Optional | Index Register for A 


REQUIRED | Address of Operand-B (the 
minuend) and the difference 
Optional | Length of Operand-B 
and difference 


Optional | Index Register for B 


of the values supplied by the assembler when 
optional parameter from the operand 
Section 1, under "Implied Operand Forms." 
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The Subtract instruction (Op Code O111) computes the algebraic 
difference between two operands. The difference replaces’ the 
minuend (Operand-B). 


Details 


The subtract operation proceeds from right to left starting with 
the rightmost character of Operand-A and Operand-B. Character 
by character, the algebraic difference is developed in Operand- 
B. 


The hardware acts as though the sign of Operand-A were reversed. 
In every other respect the instruction behaves like the Add 
instruction. 


If Operand-A is shorter than Operand-B, the operation proceeds 
normally until Operand-A is exhausted. After that, the process 
continues in similar fashion except that a zero character is 
automatically substituted every time the logic calls for a 
character from Operand-A. In effect, Operand-A is given enough 
preceding zeros to make it the same length as Operand-B. | 


If Operand-A is longer than Operand-B, subtraction stops after 
the leftmost position in Operand-B has been subtracted. The 
remaining positions in Operand-A are ignored, and do not affect 
the difference or the Condition Code. 


The algebraic sign of the difference is placed in bit-7 of the 
rightmost position of Operand-B, and bit-5 is turned on. Except 
for the rightmost character, the other zone bits of Operand-B 
are unchanged. Operand-A is unchanged by the subtract operation. 


If the difference exceeds the capacity of Operand-B, a carry-to- 
the-left from the leftmost position does not occur. Condition 
Code 4 is set to indicate the overflow. 


The instruction S *,FIELD will subtract 1 from the contents of 
the label FIELD. 


Condition Codes 


Assembler J] 


After completion of the Subtract instruction. 


Negative, non-zero difference. 
Zero difference. 

Positive, non-zero difference. 
Overflow. 


Dm WW 
|| 
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ASSEMBLER STATEMENT 


Operation Mnemonic 
W 


Operand Form 


A(D,IA),B(C,IB) Device/Channel form 
Legend 
PARAMETER RANGE REQ/OPT DESCRIPTION 
REQUIRED | Address of output area 
D REQUIRED | Device number 
IA Optional | Index Register for A 
B REQUIRED |} Count or indirect disc 
address (must be a numeric 
value ) 
C REQUIRED | Channel and Control 
IB Optional | Index Register for B 
Notes 


For a discussion of the values supplied by the assembler when 

the programmer omits an optional parameter from the operand 

specification, see Section 1 under “Implied Operand Forms." 
Channel Specification 

O. FAC, File Access Channel 

1. IOC, Input Output Channel 


2. FAC, Write Control 


3. IOC, Write Control 


11-71 2-35 Assembler I 


© 1971, The Singer Company 


MACHINE INSTRUCTION STATEMENTS 


Device Specification 


IOC devices are interchangeable in device number. Most 
installations prefer a standard setup. FAC device numbers” are 
fixed. 


STANDARD DEVICE NUMBERS 


IOC FAC 
O Workstation Dise Controller 
1 Card Reader Magnetic Tape Drive l 
2 Line Printer Magnetic Tape Drive 2 
ms Paper Tape Reader Magnetic Tape Drive 3 
4 Card Punch Magnetic Tape Drive 4 
5 és zs 


6 Paper Tape Punch = 


8 = On Line Communications Adapter 
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Disc Address 


B is the character count for any device except the disc 
controller. For the disc controller, the count is always 100. 
To select the dise controller, the programmer makes both D and C 
(Device and Channel) equal to zero. When the disc is’ thus 
specified, B becomes the indirect disc address, pointing to the 
6 character disc address field. The format of the disc address 
field is: 


In the above representation, the zone bits are not shown. Bit-5 
must be ON. Bit-7 is ignored. 


As Device number (0-9). 

Bz: Arm number (0-4). 

C: Hundreds digit (O or 1) of a three-digit track number. 
D: Tens digit (0-9) of a three-digit track number. 

E: Units digit (0-9) of a three-digit track number. 

F: Tens digit (0-9) of a two-digit sector number. 


Gs: Units digit (0-9) of a two-digit sector number. 


EXECUTION 
Effect 


The Write instruction (Op Code 0001) transmits data from 
sequential locations in Main Memory to an output device. A 
control option enables the Write instruction to communicate 
control information to the input or output device. 
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/OC General Operation 


A Write instruction that specifies data transmission through the 
I0C is executed incrementally. The instruction is first 
decoded, and parameters are set into registers A, B, and P for 
the partition initiating the operation. A signal is sent to the 
IOC to alert the output device. Control is then relinquished to 
the next partition. The transmission of characters occurs 
between the execution of instructions in the other partitions. 
Before each instruction begins, the CPU sends one character to 
each IOC which is ready to accept one. This incremental 
operation proceeds as follows: 


1. The IOC sets a signal to inform the CPU that it is ready 
to accept a character from the output area. 


2% Between instruction executions, the CPU discovers the 
Signal and checks the count balance. If the count has 
been reached, no more characters are sent to the IOC. 
If the count has not been reached, steps 3, 4, 1, and 2 
are repeated, in that order. 


5. The CPU gives a character to the IOC and updates the 
parameter registers. 


4. As soon as it can, the output device accepts the 
character. 


If control returns to the partition which initiated the Write 
instruction before the count is satisfied, control simply passes 
to the next partition. If the count is satisfied when control 
returns to the partition which initiated the Write instruction, 
a Condition Code is set (see description of individual devices), 
and execution continues with the next sequential instruction 
following the Write instruction. 


FAC General Operation 


A Write instruction that specifies data transmission through the 
FAC does not relinquish control to the next partition during 
data transmission. Instead, the CPU is devoted exclusively to 
feeding data to the FAC until the entire count is satisfied. 
service to the IOCS continues except during transmission of data 
between disc and memory. 


Disc Access Sequence 


A Write instruction addressing the disc does not typically pre- 
empt the CPU (as described above) immediately. It is sometimes 
necessary to wait until the disc is free, and then to wait while 
the heads move to the required cylinder. During either type of 
wait, control passes to the neighboring partition, and returns 
again in normal sequence. 
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A dise is free if it is not bound to another partition. It is 
bound to a given partition as soon as the partition institutes a 
seek upon it; it remains bound until data transmission is 
complete. 


If the disc is bound to another partition when a Write 
instruction is attempted, control merely passes to the next 
partition. The Write instruction will be attempted again when 
control returns to the host partition. 


If the dise is free when a Write instruction is attempted, a 
seek is automatically instituted, and the disc becomes bound to 
the host partition. If head movement is necessary, control 
passes to the next partition. Transmission begins when the 
heads reach the proper cylinder, when control returns to the 
host partition, and when the desired sector rotates into place. 


If the heads are already “on cylinder" when the seek is 


instituted, control remains with the host partition. 
Transmission begins as soon as the desired sector rotates into 
place. 


When the disc record is entirely transmitted, a Condition Code 
is set to indicate the outcome. The CPU services any 
outstanding I0C signals, and execution continues with the next 
sequential instruction following the Write instruction. 


succeeding instructions in the host partition which access the 
same cylinder will be executed without switching partitions. 
The first attempt to access another cylinder, however, will free 
the disc and pass control to the next partition. When control 
again returns to the host partition, the Write instruction will 
be subject to the entire wait process (as described above). 


Write Control 


A Write instruction may specify the transmission of control 
characters to the external input/ output device by having bit-2 
of the LB instruction field ON. The information in the output 
area is sent to the external device one character at a time and 
exerts a controlling effect. The particular effect depends upon 


the information transmitted and upon the external device. As 
soon as the last character is accepted by the external device, 
program execution is free to continue even though the 


controlling effect is not yet realized. 


1-71 2-39 Assembler I 


© 1971, The Singer Company 


MACHINE INSTRUCTION STATEMENTS 


For more information on Write Control, the reader is referred to 
Appendix E, "I/O Device Control Characters." 


Condition Codes 


After completion of the Write instruction: 


1 = Error 
2 = Normal 
5 = Flag 

4 = Fault 


For more information on Condition Codes and their meaning for 
particular devices, the reader is referred to Appendix fF, "T/0 
Device Condition Codes." 
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Section 3 
ASSEMBLER COMMANDS 


INTRODUCTION 
COMMON 


ASSEMBLER COMMANDS 


INTRODUCTION 


This section details the information related to the assembler 
commands. After the introduction, the page headings are 
arranged in alphabetical order for ease of reference: 


COMMON 
DM 
EJECT 
END 
EXEC 
NORMAL 
ORG 
SPACE 
TITLE 
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ASSEMBLER STATEMENT 


Operation Mnemonic 


COMMON 


Operand Form 


Legend 


Notes 


EFFECT 


No operand permitted. 


None. 


No label permitted. 


Scope of COMMON Statement 


A COMMON statement takes effect when it is read during assembly. 
A NORMAL statement causes this effect to stop. Thus, any 
statements following the COMMON statement and preceding the 
NORMAL statement (or END statement) are subject to the COMMON 
statement and are said to lie within its scope. When assembly 
begins, the NORMAL condition prevails. 


Constant Address Fields 


Assembler JI 


For statements within the scope of a COMMON statement, any 
unflagged constant address is assembled as though it had been 
flagged with a C to indicate an address in the common region of 
memory. This applies to the A and B field of an instruction 
statement. It also applies to address constants in the data 
field of a DM (Define Memory) statement. To assemble a constant 
address in partition from within a statement which lies within 
the scope of a COMMON statement, the programmer merely flags the 
constant with a P: : 


COMMON 
S 300(5),400P(5) 


In this example, the operand at common location 300 is 
subtracted from the operand at partition location 400. In other 
words, when the statement is assembled, AC is set ON and BC is 
set OFF. 
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Labelled Statement Reference 


Each new statement label within the scope of a COMMON statement 
is assigned an address in the common region of memory using’ the 
common memory assignment counter. Accordingly, each time the 
label is referenced, the address provided by the assembler is 
also in the common region. This holds true whether or not the 
referencing statement lies within the scope of a COMMON 
statement. 


NORMAL 
S A,B 


COMMON 

ORG 300 
A DM C10 
B DM C10 


In the Subtract statement above, the operand at location 300 
common is subtracted from the operand at location $310 common. 
Both AC and BC are turned ON because the statements labelled A 
and B are both within the scope of the COMMON statement. 


* Address Reference 


Any statements within the scope of a COMMON statement which can 
properly contain * as an address indicator will be assumed _ to 
have a common address. 


COMMON 
ORG 500 
Ss) *+100,*+200 


In the above example, the character in location 600 common is 
subtracted from the character in location 700 common. 


3-3 Assembler I 


© 1971, The Singer Company 


ASSEMBLER COMMANDS 


ASSEMBLER STATEMENT 
Operation Mnemonic 
DM 
Operand Form 


RTS'DATA'(L,1I) 


Legend 
PARAMETER RANGE REQ/OPT DEFAULT DESCRIPTION 
R Optional; 1. Repetition Factor 
T REQUIRED Data Type 
S) Optional size of Data 
DATA. Optional Initialization Data 
L Optional Length Specification 
for Label Table 
I Optional Index Specification 
for Label Table 
Notes 
Note 7 
Default value S=l for data types C and N. 
Default value S=4 for data type A. 
Examples of DM Statements are shown in figure 3-l. 
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PAGE 0001 10/12/71 


SEQ» LOCN INSTR/DATA OP 


0000 

0000 

0004 

0008 

ooOle 

0016 

0020 

002e4 

0028 

0032 

0032 

0033 

0034 SIZE EQUAL 
0048 

0128 1 

0132 BLANK FILL 
0172 TYPE AN tS 
0183 

0183 ABCDE 

0203 ABCDE 

0208 

0288 

0288 

0289 

0295 

0298 

0300 

0304 

0312 
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LABEL LOC LNTH INDX 


Cc 0208 O01 

CARD 0183 80 

CTR 0300 04 
3 LABELS 
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(4=#02) 


A/R 


ooo] 
0001 
00014 
0001 
0001 
0001 
0001 
0001 


0001 
0001 
O001 
0001 
0001 
0001 
0001 
0000 
0004 
0001 
0001 


O00] 
0001 
0001 
QO001 
0001 
0004 


(4=02) 


1 
.¢) 
¢) 


L I 87S 


0004 
0004 
0004 
0004 
0004 
0004 
0004 
0004 


0001 
0001 
0014 
0080 
0004 
0040 
0011 
0080 
0005 
0005 
0080 


0001 
0006 
0003 
0002 
0004 
0002 


L I LINE 


0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 
00114 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
one 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0030 


LABEL OPCODE 


* DM EXAMPLES 


* DM EXAMPLES 
DM 
DM 
DM 
DM 
OM 
DM 
DM 
DM 
DM 
DM 
Cc DM 
* DM EXAMPLES 


ASSEMBLER COMMANDS 


PROGRAM LISTING FOR EXAMPLES OF DM STATEMENTS 


OPERAND(S) AND/OR COMMENTS 


OF TYPE A(AUDDRESS) « 

A * SAME AS 1A4%e FOUR POSe OF MEMORY RESERVED 
A'O! FOUR ZEROS PUT INTO CORE 

A'300! ADDRESS 0300 PUT INTO CORE. 

A'6600C! COMMON ADDRESS SPECIFICATION 

A'660P! ALTERNATE WAY TO SPECIFY COMMON ADDRESS 
A'6600P! PARTITION ADDRESS SPECIFICATION. 
A'¥4+40' ADDRESS OF CURRENT LOC* PLUS 406 
A'CARD! * ADDRESS OF LABEL CARD PUT INTO CORE 

OF TYPE C(CHARACTER) « 

C * ONE POSITION OF CORE RESERVED. 

cree * UNE APOSTROPHE PUT INTO CORE 

C'SIZE EQUALS 14! * SIZE IS NOe OF CHARACTERS. 
C80 * EIGHTY POSITIONS OF CORE RESERVED 

C41! * ONE FOLLOWED BY THREE BLANKS PUT INTO CORE 
C4O'BLANK FILL AFTER! * BLANKS UNTIL SIZE = 406 
Ci1'TYPE AN fHGies * TwO APOSTRUPHES TO MAKE ONEs 
OC80 * NO POS« OF CORE RESERVEDs BUT S#8065 
4C5'ABCDE! * FOUR SETS OF ABCDE PUT INTO CORE. 
CS'ABCDE' (3) * LENGTH IS THREE WHEN REFERENCEDe 
C80(141) * INDEX REGe POINTS TO CHARe IN RECORDs 
OF TYPE N({NUMERIC) 

N * ONE POSITON OF CORE RESERVEDe 

N6 SIX POSITIONS OF CORE RESERVED. 

N'365! 365 PUT INTO COREs 

Nt#65! 6U PUT INTO CORE* SIGN MUST BE FIRSTe 
N4Fit LEFT ZERO FILL #0001 PUT INTO CORE. 
4N'25! FOUR SETS OF 25 PUT INTO COREs 


LABEL TABLE FOR EXAMPLES OF DM STATEMENTS 


MESSAGES 


UNUSED 


UNUSED 


Figure 3-1. 


3-5 


Examples of DM Statements 
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ASSEMBLER COMMANDS 


Note 2 
Data type governs data range: 
N (Numerical) data type: 


Range is limited by space available in statement for the 
"'DATA' field. | | 


Data may be preceded by + or -. 


Number of characters in data field (excluding + or -) 
may not exceed 8S. 


C (Character) data type: 
Any System Ten character is allowable. 
To assemble an embedded apostrophe, use two apostrophes. 


To assemble an embedded percent sign, use two percent 
signs. | | 


Number of characters is limited by space available in 
statement for the 'DATA' field. 


Number of characters to be assembled may not exceed S. 
A (Address) data type: 
Range, O-9999. agar represented symbolically. 
Note 3 
Default L=S if S is explicit. 


If S is omitted, default L=number of characters to be assembled 
from data field. 


If S and data field are omitted, default L=l. 
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EFFECT 


The Define Memory statement is used to specify data fields. The 
assembler assigns addresses, assembles initial data into the 
assigned addresses, and (for each labelled DM _ statement) 
maintains associated address, length, and index parameters in 
the label table. 


Alignment considerations 


The assembler makes no attempt to align space reserved by DM 
statements at tens boundary addresses (as required for machine 
instruction statements). For a given DM statement, the 
assembler simply asSigns the next location beyond those required 
by the previous statement. 


Data Types C, N, A 


The programmer specifies the data type for each DM statement by 
writing C, N, or A in the position reserved for T in his 
assembler statement. If he wants data assembled, he specifies 
the data in the data field, but in conformity to the 
requirements of type. 


Type C 


Type C (Character) data includes any System Ten character. cf 
the programmer encodes a data field which is shorter than _ the 
field width 8S, the given information is left adjusted and filled 
with trailing blanks. To assemble an apostrophe into the data 
field, the programmer uses two adjacent apostrophes for every 
one he wishes assembled. The first and last apostrophes (which 
show the bounds of the data field) are not considered part of 
the data and are not assembled. To assemble a percent sign into 
the data field the programmer uses two adjacent percent signs 
for every one he wishes assembled. | 


Type N 


Type N (Numerical) data includes digits O-9. The numerical 
information can be optionally preceded by a plus (+) or a minus 
(-) sign. Only one such sign can be included in the data field 
(between the bounding apostrophes); when used, it must always be 
the first character in the data field. If the given information 
is preceded by a minus sign, bit-7 of the rightmost digit of the 
assembled field is turned ON. If the programmer encodes a data 
field which is shorter than the field width 5, the given 
information is right-adjusted, and the field is filled with 
preceding zeros. 
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Type A 


Type A (Address) DM statements are used to assemble addresses 
into data fields. Each assembled field will contain a four 
digit address. If the address refers to the common region, bit- 
7 of the rightmost digit is set ON. If the address refers to 
memory in the partition, bit-7 is set OFF. 


If the programmer provides S (field width) in his DM statement, 
it must be 4 (for Type A). If he omits S, it is assumed to be 
4. 


The information the programmer provides in the data field is 
governed by the same rules as are used in writing addresses in 
machine instruction fields A and B. 


The information inside the bounding apostrophes must be one of 
the following: 


* 


*constant 

(flagged) constant 

(flagged) constant constant 
symbol 

Symbol constant 


Field Width 


Ss determines the field width, and R determines the number of 
times the field is repeated. Rx S + assembly-address cannot 
exceed 9999. If S is omitted, and if data is given, the data 
determines the field width. 


If both S and data are omitted, space is reserved on the basis 
of S=l1 for C and N data types, and S=4 for A data type. 


Repetition and Space Reservation 


Assembler I 


R determines the number of times the field is repeated in 
memory. 


If R is zero, no memory is reserved, and no data are assembled 
for loading. If such a statement contains a label, however, the 
label is entered into the label table along with the associated 
address, length, and index register. 


If R is more than 0, and if the programmer supplies data, the 
field is assembled R times in adjacent memory locations. If the 
programmer omits the data field, R x S locations are reserved 
but the contents of the reserved locations are unspecified. 
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Initial Data 


Length 


The rules which govern initial data are described above under 
"Data Types". If the data field is omitted, no code is 
assembled, although the other functions of the DM statement are 
performed by the assembler. 


Length is the value which the assembler inserts in the label 
table as the implied length associated with a given label. If, 
in a machine instruction statement elsewhere in the program, a 
length parameter is omitted and the associated length address 
field (A or B) is a symbol, the length is supplied by the 
assembler from the corresponding label table entry. 


L determines what length the assembler inserts into the label 
table. If L is omitted, the field width (described above) is 
used. If the field width exceeds 1003; L should be explicitly 
given (not omitted) if it is to be used as described above. L 
Should never exceed 100. 


If the DM statement is unlabelled, no entry is made in the label 
table. 


Caution 


Index 


Whenever the assembler inserts an implied length into an 
instruction field, the length taken from the label table must be 
consistent with the length permitted by the operand form. For 
the two-length form, the length supplied from the label table 
cannot exceed 10, while for the one-length form, the length 
cannot exceed 100. If this rule is violated, the message EXCESS 
LENGTH is printed in the label table listing for each label 
where the length is too large to be assembled into a referencing 
instruction. After the label table is printed, the assembly is 
discontinued without proceeding to pass 2. 


Index is the value which the assembler inserts in the label 
table as the implied index register associated with a given 
label. If, in a machine instruction statement elsewhere in the 
program, an index specification is omitted and the associated 
address field (A or B) is a symbol, the index is supplied by the 
assembler from the corresponding label table entry. 
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I determines what index the assembler inserts in the label 
table. If I is omitted, O is inserted. 


If the DM statement is unlabelled, no entry is made in the label 
table. 


Implied Forms 


Assembler I 


Except for the T (type) parameter, any of the other parameters 
in the DM statement can be omitted: 


When the data field is omitted, the bounding apostrophes 
Should be omitted also. 


When the L parameter is omitted and I is given, the 
separating comma should be retained. 


When L is given and I is omitted, the separating comma 
Should be omitted also. 


When both L and I are omitted, the bounding parenthesis and 
separating comma should be omitted also. 


When a parameter is omitted, the assumption which the assembler 
makes about the omitted parameter is as described in the 
preceding discussion starting with "Effect." 
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ASSEMBLER STATEMENT 
Operation Mnemonic 
EJECT 
Operand Form 


No operand permitted. 


Notes 

No label permitted. 

EFFECT 
The EJECT statement advances the listing of the source program 
to the top of the next page. 
An EJECT statement is not copied to the source program listing. 
EJECT has no effect when the workstation is used as the print 
device. 
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ASSEMBLER STATEMENT 
Operation Mnemonic 
END 
Operand Form 


No operand permitted. 


Legend 
None. 
Notes 
No label permitted. 
EFFECT 
The END statement is taken by the assembler to be the last 
statement in the source program. 
There must be (only) one END statement in every source program. 
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ASSEMBLER STATEMENT 


Operation Mnemonic 


EXEC 


Operand Form 


Legend 


Notes 


EFFECT 


11-71 


Object 


* 


* constant 

Symbol 

Symbol constant 

(Flagged) constant 

(Flagged) constant constant 


The operand specifies the address at which execution will begin. 


No label permitted. 


EXEC does not terminate the assembly process (as does the END 
statement). 


EXEC generates an 5 card in the object program containing the 
address specified by the programmer. The S card is interpreted 
during loading. It stops the loading process and passes control 
to the specified address. 


Use in Overlays 


If a source program contains several overlays, the last 
statement of each overlay must be an EXEC statement pointing to 
the start address for the given overlay. EXEC, used in this 
manner, causes loading to stop after the overlay has’ been 
loaded. Control then passes to whatever location the programmer 
specifies in the EXEC statement. 


Resumption of Loading 


The loader normally resides in partition location 50-299 
throughout execution of a program. Typically, the statement 
ahead of each EXEC statement (for all overlays except the last) 
is a branch to the loader (location 60) to begin loading the 
next overlay. 
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ASSEMBLER STATEMENT 
Operation Mnemonic 
NORMAL 
Operand Form 


No operand permitted. 


Legend 
None. 
Notes 
No label permitted. 
EFFECT 


Scope of NORMAL Statement 


A NORMAL statement takes effect when it is read during assembly. 
A COMMON statement causes this effect to stop. Thus, any 
statements following the NORMAL statement and preceding the 
COMMON statement (or END statement) are subject to the NORMAL 
Statement and are said to lie within its scope. When assembly 
begins, the NORMAL condition prevails. 


Constant Address Fields 


For statements within the scope of a NORMAL statement, any 
unflagged constant address is assembled as though it had been 
flagged with a P to indicate an address in the partition region 
of memory. This applies to both the A and B field of an 
instruction statement. It also applies to address constants in 
the data field of a DM (Define Memory) statement. To assemble a 
constant address in common from within a statement which lies in 
the scope of a NORMAL statement, the programmer merely flags the 
constant with a Ce: 


NORMAL 
S 300(5),400C(5) 


In this example, the operand at partition location 300 is 


subtracted from the operand at common location 400. In other 
words, when the statement is assembled AC is set OFF and BC is 
set ON. 
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Labelled Statement Reference 


Fach new statement label within the scope of a NORMAL statement 
is assigned an address in the partition region of memory using 
the partition memory assignment counter. Accordingly, each time 
the label is referenced, the address provided by the assembler 
is also in the partition region. This holds true whether or not 
the referencing statement lies within the scope of a NORMAL 
statement. 


COMMON 
S A,B 


NORMAL 
ORG 300 
A DM C10 
B DM (C10 


In the Subtract statement above, the operand at location 300 
partition is subtracted from the operand at location $310 
partition. Both AC and BC are turned OFF because the statements 
labelled A and B are both within the scope of the NORMAL 
statement. 


* Address Reference 


Any statements within the scope of a NORMAL statement which can 


properly contain * as an address indicator will be assumed _ to 
have a partition address. 


NORMAL 
ORG 500 
S e+ 1LOO.. 7 +200 


In the above example, the character in location 600 partition is 
subtracted from the character in location 700 partition. 
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ASSEMBLER STATEMENT 


Operation Mnemonic 


ORG 


Operand Form 


Notes 


Assembler I 


* 


* constant 

symbol 

Symbol constant 

(Flagged) constant 

(Flagged) constant constant 


Label permitted. 


The operand may be omitted, in which case the memory assignment 
counter is set to the highest value yet attained by it during 
the current assembly. If the operand is omitted, at least 8 
blank characters must lie between the operation field and _ the 
first character of the comment. 


A symbol in the operand of the ORG statement pre-supposes that 
the symbol already has a defined value in the label table. 
Failure to pre-define a symbol (by using it as a statement label 
in an earlier statement) results in an assembly error. 


If the operand is a symbol or a flagged constant, the resultant 
address must be in common if a COMMON statement is in effect; 
the address must be in partition if a NORMAL statement is in 
effect. The following violates this rule and constitutes an 
errors: 


COMMON 


ORG 500P 
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EFFECT 


11-71 


Memory 


Memory 


ORG sets the current memory assignment counter (common or 
partition) to whatever value is specified in the operand. The 
statement produces no object code. 


Assignment Counters 


The assembler maintains two memory assignment counters: one for 
assigning addresses to statements in the scope of a COMMON 
statement (the common counter) and one for assigning addresses 
in partition (the partition counter). When the assembler is 
loaded, the partition counter is used; it contains the value 
OOOO. The common counter contains the value OOOO. 


The assembler uses the partition counter until a COMMON 
statement is encountered. It then uses the common counter until 
a NORMAL statement is encountered, at which time it returns to 
using the partition counter (at the value attained before the 
COMMON statement). Similarly, another COMMON statement 
reinstitutes the use of the common counter (at the value 
attained before the NORMAL statement). 


Assignment Process 


Fach DM statement is assigned space starting with an address 
whose value is that of the memory assignment counter currently 
in use. A DM statement preempts RxS characters (providing of 
course that these parameters are explicitly coded). 


Fach machine instruction statement is assigned 10 characters 
starting with the address whose value is that of the memory 
assignment counter after it is first adjusted, if necessary, to 
a tens boundary. 


The other assembler commands do not preempt space and (except 
for the ORG statement) do not affect the memory assignment 
counter. 


After each statement is processed, the memory assignment counter 
is incremented by whatever number of characters the statement 
preempts, and processing continues with the next statement. 


The ORG statement causes a departure from this systematic 
process. The statement causes the current memory assignment 
counter (common or partition) to be set as specified in the 
operand field of the statement. 
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ASSEMBLER STATEMENT 


Operation Mnemonic 


SPACE 


Operand Form 


Notes 


EFFECT 


Assembler J] 


A constant (range 1-99). 


No label permitted. 


The SPACE statement causes the generation of blank lines on the 
listing of the source program. The operand determines’ the 
number of blank lines. 


If the operand equals or exceeds the number of blank lines 
remaining on the current page, the paper merely advances to the 
top of the next page. 
If the operand is less than the number of blank lines remaining 
on the current page, the number of blank lines specified by the 
operand are generated. 


If the operand is omitted or O, one blank line is generated. 


A SPACE statement is not copied to the source program listing. 
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ASSEMBLER STATEMENT 


Operation Mnemonic 


TITLE 


Operand Form 


Legend 


Notes 


EFFECT 


11-71 


"title text enclosed by apostrophes' 


Use two apostrophes for each apostrophe to be printed. 


Label not permitted. 
The TITLE statement, if used, must precede all other statements. 


Each assembly can process only one TITLE statement. 


The title text is stored in a buffer internal to the assembler. 
Each time the assembler begins a new page in the listing, it 
prints a line containing the title text. 
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INTRODUCTION 

LISTING OUTPUT 
ERROR MESSAGES 
OBJECT DECK FORMATS 


ASSEMBLER OUTPUT 


INTRODUCTION 


This section describes the output generated by the assembler. 
First, the listing output is described, after which the object 
deck formats are described. Figure 4-1 is an example of the 
program listing and output generated by an error-free Assembler 
I source program, with the optional cross-reference listing 
included. 


LISTING OUTPUT 


1-71 


The listing output is generated on whatever device is specified 
as the listing device. (See Appendix As Assembler Deck 
Parameters.) If the printer is used as the listing device, it 
will skip to the top of a new page before printing the first 
line of output. 


The listing output has four types of listings. 


l. Error Statement Listing (generated only if errors are 
encountered). 


2. Label Table Listing (created in all cases). 


53. Program Listing (produced only if no errors’ are 
encountered). 


4. Symbol Cross-Reference Listing (output if requested by 
the user, and only if no errors are encountered). This 
feature is provided only with the dise version of the 
assembler. 


The program title (if specified in the TITLE assembler command 
statement) and the date (if entered via the DATE assembler 
parameter statement) appear in the headings on each page of all 
of the above documents. 


4-1] Assembler I 


© 1971, The Singer Company 


ASSEMBLER OUTPUT 


Error Statement Listing 


During pass 1, each statement is checked for errors and each 
erroneous statement is listed in the Error Statement Listing. 
The listing consists of these fields: 


Field 
Heading Contents 


SEQ The line number assigned to 
| this statement by the 
assembler, according to its 
actual position in the source 
code assembled. 


LOCN The actual location in core 
of the erroneous machine 
instruction or data field. 
The notation **** in this 
field indicates an out-of- 
bounds address (above 9999), 
or an attempt to set the 
memory assignment counter to 
an erroneous value (via an 
ORG statement). 


Ee aed O on oO acetate The erroneous source state- 

(Headings on every ment. Within the source 

tenth column, 1-80.) Statement, each error is 
flagged with an asterisk on 
the following line. Where an 
asterisk appears to the 
immediate left of a source 
statement label, this means 
that the label was previously 
defined in another source 
statement. The SEQ and LOCN-: 
fields refer only to the 
current error statement, and 
not to any previous statement 
having the same label. 


If there are any errors, the assembly will be discontinued after 

the label table has been printed (pass 2 will mot occur). An 
example of an error statement listing with the associated label 
table appears in figure 4-2. 
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PAGE 0001 10/12/71 (402) PROGRAM LISTING FOR EXAMPLE OF AN ASSEMBLER ONE EXECUTABLE PROGRAM 


SEQe LOCN INSTR/DATA OP AvYR tL IT B/S L I LINE LABEL OPCODE OPERAND(S) AND/OR COMMENTS 


0000 0002 THIS EXAMPLE CALCULATES A BASEBALL PITCHER'S EARNED RUN AVERAGE®s 
0000 0003 THE INPUT IS FROM CARDS WITH UP TO TEN SETS OF DATA ON A CARD. 
0000 0004 THE OUTPUT IS TO THE WUORKSTATION® 

0000 0005 ORG 11 

0011 0006 OM N4 


0015 0008 5000 

5000 Q@U2U040011 13 0909 : ZERO, XR1 * ZEROS TO REGISTER 

5010 1528710080 0010 INPUT(1)» 80(1) * READ A CARD FROM THE READER 

5020 SS5SRU&800000 0011 BLANKS(3) * END JOB IF UNIT SEPERATORe 

5030 PUR873U258 0012 IP» BLANKS * IS REST OF CARD BLANK? 

5040 RSPPOO00000 0013 INIT(2) * YES» READ NEXT CARD» 

5050 QU2U035373 0014 ZERO,» QUOT+6(3) * CLEAR OUT LAST 3 POSe OF DIVIDEND 
5060 SU2X73U376 0015 IPs DIVSOR(3) * PUT IN LEFT MUST 3 POSITIONSs 
5070 1UR5135376 0016 THREE» DIVSOR(3) * RESULT IS FOUR POSITIONS. 

5080 12904376 0017 FIP» DIVSOR * ADD TO RESULT 

5090 SU2Y14U367 0018 RUNS» QUOT(4) * LEADING ZERO ASSUREDe 

5100 2UR5235368 0019 TWOSE Vs QUOT+1(3) * DIVIDEND IS Os» 5S POSITIONSs AND 
5110 4U3W655367 0020 DIVSOR,s QUOT »* 3 TRAILING ZEROS FOR 3 DECIMAL PLACES 
5120 TSRROQONDONDO 0021 ERRWRT(4) CHECK FOR OVERFLOWe 

5130 1025655367 0022 FIVEs QUOT ROUND OFF RESULT 

5140 P5261653R0 0023. EDITOMs ERA MOVE IN EDIT MASK 

5150 PU36745380 0024 QUOT( 4)» ERA PUT ANSWER IN WITH EDITING 

5160 P538065273 0025 ERA» MSG+6 ANSWER TO MESSAGE 

5170 0520730001 0026 CR(O)» 1(3) CARRIAGE RETURN ON WORKSTATIONe 

5180 052@v710012 0027 MSG(0O)s 12¢1) WRITE ANSWER ON WORKSTATIONe 

5190 1U25440011 0028 EIGHT» XR1 TO GET NEXT SET OF DATA 

5200 PURS420013 0029 EIGHT(2)s XR1+2 * HAS THERE BEEN 10 SETS OF DATA? 

5210 RS5PP055030 0030 INIT(2). LOOP(S) * YESs»REAL CARD: NOs» PROCESS DATAe 
$220 05@uU730001 0031 ERRWRT CR(O)» 1(3) * CARRIAGE RETURN ON WORKSTATIONe 

5230 052w910008 0032 ERRMSG(0)s8(1) * WRITE OVERFLOW MESSAGE ON WORKSTATION 
5240 USRUB00000 it 0033 BLANKS(5) * END JOB 


sre 
a a 


a 
ee Ke KKK EK 


OconorccececeoerF FNWRFPKYPWRHNOWPR 
OQ 


oeoooocoqooococooornrvr orf OOF COC 
CrWONFRP WO FOUNOOWF FW WWOWOr + 
coocoooogoococoococococcooo 


BOazaernnrzztam 


a 


5250 0035 : N!'O! 

5251 0036 N'3! 

5252 0037 N'27) 

5254 0038 i N'8O*(1) 

5256 0039 N'5! 

5257 0040 cit 

5258 0041 ; c3' 

5261 0-00« 0042 C' O+00+! 

5267 ERA ® 0020 0043 C'ERA = 0000 ! 

5279 OVERFLOW 0044 : ) C'OVERFLOW! 

5287 0045 

5287 0046 INNINGS PITCHED 

5290 0047 FRACTIONAL INNINGS PITCHED#=051s0R 20 
5291 0048 3 : EARNED RUNS ALLOWED 

5294 0049 REMAINDER OF CARD IMAGE 

5367 0050 ANSWER OF DIVIDE WILL BE 5S POSITIONS. 
5372 0051 DIVIDEND WILL INCLUDE THESE POSITIONS 
5376 0052 DIVSOR 

5380 0053 ERA EARNED RUN AVERAGE 


5386 0055 : INIT 
5386 0056 


PAGE 0001 10/12/71 (4=#02) LABEL TABLE FOR EXAMPLE OF AN ASSEMBLER ONE EXECUTABLE PROGRAM 
LABEL LOC LNTH INDX MESSAGES 


BLANKS 5258 
5257 
5376 
5261 
5254 
5380 
5279 
5220 
5290 
5256 
5000 
5287 
5287 
5030 
5267 
5367 
5291 
5251 
5252 
0011 
5250 

2i LABELS 


PAGE 0001 10/12771 CROSS REFERENCE LISTING 


DEF. SYMBOL Coo ee Pere seoresetereoseee PREFERENCE Se meee neranretovneveeseesee 


0040 BLANKS 0010 0011 0032 
0039 0025 0030 

0051 00414 0015 0016 
0041 0022 

0037 ; 0027 20028 

0052 OQQo22 9023 Oo024 
0043 0031 

0030 0020 

0046 0016 

0038 0021 

0008 0012 

0044 0009 

0045 0011 

ooi1 0029 

0042 One4 

0049 0013 0018 0019 O021 0023 
0047 0017 

0035 0015 

0036 0018 

0005 0008 

0034 0008 


ooo0ooro0qc or ocor OcooocdcSe 


Figure 4-1. Error-Free Assembler Output 
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0001 10/12/71 


LOCN 


0000 DMO1 OM NAt4444I 
HEX * 

0004 DMOoe2 DM BA'7777! 
EMM ey 

0008 NO'333! 
HAHN * 

0011 OMO4 N'07#24=70! 
RHRH ¥ 4» 
0017 DMOS5 A5'44ayt 
HERE * 

o022 DMmO6 D'1010!8 
HEE * 

0026 DMQ7 6' 4220! 
ere) , * * 
0026 DMO8 C80" '( 94) 
RRS * 
0106 OMO9 DM C4' AaB 

HERS 
0106 
HENH 
0110 
HMR H 
0114 
ARRM 
0139 DM13 OM ONO!7777! 

MERH * 

0139 OM14 DM CC6'HELLO! 
HHH * 

0144 OmM1LS Nt4qat 

MONE * 

0150 OM16 

ERK 
0160 
HEH 
0170 DMO1sDM03(J 
ERE * 
0180 DM022DM04(6 
HER * 
0190 EOF (3) sERMS 
HORE 
0200 


DMO3 


DM10 C4AaCD! 
HORRY 
A'BC ! 
4% 


C25'THE SIZ 


DM 


DMil DM 


DM1ie2 DM 


DM16 


(20)2DM05 
AHR MRRRM EH HY 
0210 BD MCO1(5) 
EMR * * 
0220 8C MCO1(2)» 
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Label Table Listing 


For every label in the source program, the label table presents 
the following information in the fields indicated: 


Field 

Heading Contents 

LABEL The symbol used as the statement 
or data field label. (These 
Symbols are listed in alphabetic 
order.) 

LOC ; The location in core assigned to 
the label. If label is undefined, 
line number of undefined state- 
ment. 

LNTH The length attribute associated 
with the label. (** indicates a 
length greater than 100). 

INDX The index register attribute 
associated with the label. 

MESSAGES Any messages regarding the label 


Symbol, such as UNUSED (to 
indicate that this symbol is 
used as a label but is not 
referenced as an operand by any 
Statement) or UNDEFINED (to 
indicate that the symbol is ref- 
erenced aS an operand but does 
not appear as a label in any 
Statement.) When a symbol is 
listed as UNDEFINED, the line 
number (assigned by the assem- 
bler) of the last record contain- 
ing the symbol as an operand will 
appear under the LOC heading (in 
place of a core location). The 
message EXCESS LENGTH is printed 
for each label where the length 
is too large to be assembled 
into a referencing instruction 
(see Caution under DM statement 
effect in Section 3). 


At the end of the label table listing, the message "nnn LABELS" 
is printed, where nnn is the number of labels in the source 
program. 
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Program Listing 


Assembler I 


The program listing is created only if no errors are detected 
during pass l. The program listing is generated during pass 2, 
and consists of a line-by-~line listing of the source program. 
It contains the following information: | 


Field 
Heading Contents 


SEQ. sequence number (if any) copied from 
positions 77 through 80 of each record 
assembled. 


LOCN. The actual beginning location in core 
of the machine instruction or data. 


INSTR/DATA The machine language representation of 
the machine instruction, or in the 
case of DM statements, up to the first 
ten characters within the apostrophes 
(blank or zero fill not included). 


OP The function code for machine instruc” 
tions, in hexadecimal representation. 


A/R For machine instructions, this column 
contains the address of the A-operand; 
for DM statements, this column 
contains the repetition factor. 


L The contents of the LA field of the 
machine instruction. 


I The contents of the IA field of the 
machine instruction. 


B/S For machine instructions, this field 
contains the address of the B-operand; 
for DM statements, this field contains 
the size factor. 


L The contents of the LB field of the 
machine instruction. 


I The contents of the IB field of the 
machine instruction. 


LINE The line number assigned to this 
statement by the assembler, according 
to its actual position in the source 
code assembled. 


LABEL The statement label as in the source 
statement. 


OPCODE The statement operation code, as in 
the source statement. 
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OPERAND(S) 


COMMENTS 


Symbol Cross-Reference Listing 


The statement operand(s) as in the 
source statement. 


Any user comments associated with the 
statement. 


The optional symbol cross-reference listing is requested with 
the XREF=YES assembler parameter statement. This option is 


available only 


listing contains 


encountered: 


Field 
Heading 


DEF 


SYMBOL 


REFERENCES 
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with the disc version of the assembler. The 
the following information for each label 


Contents 


The number of the statement line 
where the label was defined. (This 
is the line number assigned to the 
statement by the assembler, according 
to its actual position in the source 
code assembled.) 


The symbol used as the label. 
The line number of each statement 


referencing the label symbol as an 
operand. 
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ERROR MESSAGES 


events encountered during 


To indicate errors or significant 
assembly, various messages are output. These are described 
below. 


Message Meaning and Correction 


A) ASMID 


:END OF ASSEMBLY 


ERRORS DETECTED 


NO END STNT 


SYMBOL TABLE FULL 


T) ASMID :DISC ERROR AT (adr) 


T) ASMID :QUTPUT FILE NOT NULL 


T) ASMID :NO EXISTING pppppp 


T) ASMID :NO EXISTING 
pppppp. ffffff 


Assembler I 


The assembly is complete. If a cross- 
reference listing was requested, this 
will follow. Check all listing output, 
prepare to load and execute object 
program. 


At least one error occurred and will be 
noted in the error statement listing, 

or a source statement referenced an 
undefined label. Check error statement 
and label table listings, correct errors, 
and reassemble program. 


An END statement was not included in the 
source program. Append an.END card and 
reassemble program. 


All storage allocated for the symbol 
(label) table has been used. Change 
columns 12-19 of the first card in the 
assembler object deck to increase the 
boundaries of the label table in common 
core and reassemble the program. 


An error occurred during reading of the 
source input from disc file, or writ- 
ing of object output onto disc file. 
(This could include the disc pool or 
file label). The address where the error 
occurred is indicated by adr. Control 
returns to the DMF conversational 
loader, and the message ENTER PROGRAM 
NAME is output on the console. If 

the error occurred during reading of 
the source file, re-file the source 
program. If the error was encountered 
during writing of the object output, 
change the output file designation. If 
the pool or file label could not be 
read or written correctly, consult the 


Disc Management Facility User's Reference 
Manual. 


The file designated for object output 

was not a null file. Control returns 

to the DMF conversational loader, and the 
message ENTER PROGRAM NAME is output 

on the console. Change the output 

file to a null file, or select for out- 
put another file that is already null. 


The pool designated pppppp cannot be 
located. Control returns to the DMF 
conversational loader and the message 
ENTER PROGRAM NAME is output on the 
console. If the pool does not exist, 
create it. If it does exist, check 
to see that it is referenced by its 
correct name. 


The file designated ffffff in pool 
pppppp cannot be located. Control 
returns to the DMF conversational 
loader and the message ENTER PROGRAM 
NAME is output on the console. If 

the file does not exist, create it. 

If it does exist, check to see that it 
is referenced by its correct name and 
is stored within the correct pool. 
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Where Output 


Console print-out. (The 
console can be a Work- 
station or a Communica- 
tions Terminal). (Out- 
put only on disc version 
of the assembler. ). 


End of Label Table 
Listing. 


End of Error Message 
Listing. 


Label Table Listing 


Console print-out (Out- 
put with disc version 
only). 


Console printout (Out- 
put with disc version 
only). 


Console printout. (Out- 
put with disc version 
only). 


Console printout. (Out- 
put with disc version 
only). 
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OBJECT DECK FORMATS 


If no errors are detected in pass 1, the source deck is 
considered to be free of errors and the assembler proceeds’ to 
pass 2 and generates the object deck on whatever output device 
is specified as the object device (See Appendix Az Assembler 
Deck Parameters). (If errors are detected, no object deck is 
generated.) The object deck is serialized in columns 77-80. 
Column 1 of each object card is an alphabetic character showing 
card type. 


T Card 
Format 
Column 1 T 
2-3 Number of characters to be loaded (from card 
columns 8-70). 
4-7 Address into which first character (column 8) 
will be loaded. 
8-70 Object code to be loaded. 
71-76 Program Identification 
(copied from first source card). 
77-80 Card sequence number. 
Note 
The T card is the only format used for loadable object code. 
S Card 
Format 
Column 1 S 
270 Start Address 
71-76 Program Identification 
(copied from first source card). 
77-80 Card sequence number. 
Note 


11-71 


The S card is generated by the EXEC command. 


The S card causes the loader to cease loading and to pass 
control to the loaded program at the start address. 
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Section 5 | 
USING THE ASSEMBLER 


ASSEMBLER | (CARD VERSION) 
ASSEMBLER | (DISC VERSION) 


USING THE ASSEMBLER 


The procedures for installing Assembler I and uSing it to 
assemble source programs are described in this section. These 
procedures for the card version and disc version of the 
assembler differ, and are therefore discussed separately. 


ASSEMBLER | (CARD VERSION) 


H-71 


The user prepares the card version of the assembler by arranging 
a deck that consists of any System Ten object card loader, the 
pass 1 assembler deck (optionally including cards containing 
assembler parameter statements), the user's source programs, and 
the pass 2 assembler deck. Using a command entered on the 
Workstation or Communications Terminal, he loads this combined 
deck through the card reader, and the assembly process begins. 
Detailed directions follow. 


Fixed Parameters 


Assembler I (Card Version) is furnished to the customer as an 
object card deck. The first card in this deck (identified as 
OOOl in columns 77 through 80) contains the fixed assembler 


parameters used to specify various input/output options. 


Typically, ina card system, the fixed parameters are set when a 
system Ten is installed and are rarely changed. However, when 
changes are necessary, they are implemented by substituting for 
the first card another card containing new parameters. 


The fixed parameters are contained in columns 8 through 39 of 
the first card. 
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Assembler J 


The 


entries in the fixed parameter card columns are as follows: 


Card Column 


8 


10 


aie 


l2-15 


L67L9 


20-23 


24-27 


28-29 


50-37 


Entry 


Source Device Number (usually I0C 
Device 1, the card reader). 


Listing Device Number (usually IOC 
Device 2, the line printer). 


Object Device Number (usually IOC 
Device 4, the card punch). 


Not used. 


Lower bound of Label Table in Common 
Core. (Rightmost character must be an 
alphabetic character P to Y to indicate 
a negative number, and thus a Common 
Core address.) This address cannot 

be lower than 300. 


Upper bound of Label Table in Common 
Core. (Rightmost character must be 
an alphabetic character P to Y to 
indicate a negative number, and thus 
a Common Core address.) 


Object card trailer control charac-— 
ters. The assembler sends these char- 
acters (via the Write Control Mode) 
to the object device after each 
object card is generated. 


Maximum number of lines that can be 
printed on each page of listing out-— 
put. 


Not used. 


Default date to go on assembly list- 
ing (if no DATE= assembly parameter 
statement is entered). (This entry 
is originally blank.) 
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38 Default disposition of debug cards 
if no DEBUG= assembly parameter state- 
ment is entered). 


$ = Ignore source cards con- 
taining $ in column l. 
(This is the entry origin- 
ally in column 38.) 


* = Assemble source cards 
containing $ in column l. 


39 Default disposition of Common object 
text. 


Y = Punch Common object text. 
(This entry is originally 
in this column. ) 


9 = Assemble Common object 
code, but suppress it 
from the object deck. 


40-46 Constants used by the assembler. 
47-70 Not used. 

71-76 Program Pasuueeoaeioe: 

77-80 Card sequence number OOO1. 


Variable Parameters 


The variable assembler parameters vary from job to job. They 
are used to declare the following options which override the 
corresponding default entries in the fixed parameter card: 


° The date to appear in the listing output. 
‘ The disposition of Debug Cards (ignore or assemble). 


: The disposition of Common text object cards (punch or 
no-punch). 


The variable parameters are entered through assembler parameter 
statements punched on cards and placed in the assembler object 
deck, behind the first S-card but before the first Unit 
Separator card (punched 11-7-8-9 in column 1). After the 
portion of the assembler. ahead of the S-card is loaded, control 
passes to it and the variable parameter cards are read. As each 
card is processed, the corresponding fixed-parameter default 
entry is overwritten in memory as indicated below. If, for any 
of these fixed parameters, no corresponding variable parameter 
card is processed, that fixed entry remains the same. 
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Assembler Parameter 

Parameter Card Column Value 

Statement Affected Inserted Effect on Assembly 

DEBUG=YES 34 a Debug cards are 
assembled. 

DEBUG=NO 34 $ Debug cards are 
ignored. 

COMTXT=YES 35 Y Common object text 
is punched. 

COMTXT=NO 35 9 Common object text 
is not punched. 

DATE=mm/dd/yy 26-33 mm/dd/yy | Date specified is 


printed on list- 
ing, where mm = 
month, dd = date, 
yy = year. 


Any assembler parameter statement can be cancelled by a 
succeeding statement. For example, DEBUG=YES followed by 
DEBUG=NO leaves the assembler parameter corresponding to 
DEBUG=NO in memory. 


Assembling Source Programs 


Assembler I 


With the card assembler, various devices can be used for input 
of the user source program and output of listings and the object 
program. In the following directions, the most typical device 
assignments are assumed, as follows: 


IOC No. 
Device Assigned Function 


Workstation Initiate loading. 


Installation of assembler and 
input of source program. 


Card Reader 


Line Printer Output of listings. 


Card Punch Output of object program. 


Standard device number assignments are shown in appendix G. 


The first card (sequence number OOO1) of the assembler object 
deck must contain the proper parameters to designate the card 
reader, line printer, and card punch IOC numbers as the source, 
listing, and object devices, respectively. 


5-4 W-71 


© 1971, The Singer Company 


1-71 


© 1971, The Singer Company 


USING THE ASSEMBLER 


To prepare for assembly, put the following in the card reader's 
input hopper in the order shown (see figure 5-1): 


1. The object card loader. 


2. The Pass 1 assembler deck (including embedded parameter 
cards). 


Os The source deck to be assembled. 
4. The Pass 2 assembler deck. 


Press the LOAD and LOCAL buttons on the Workstation 
Simultaneously. Press the Workstation's ONLINE button and enter 
the bootstrap instructions 


1001010290 
This will initiate loading and assembly. 


During Pass 1, the source deck is checked for errors, and the 
Label Table is constructed. Near the end of Pass l, the first 
few cards of the Pass 2 assembler deck are read, and the Label 
Table is sorted into alphabetical order. 


If errors are detected, the assembly process ends with the 
completion of Pass 1, and the output is as follows: 


1. A listing of all erroneous statements (the errors are 
flagged with asterisks under the errors), 


2. the label table listing, with label error messages (if 
any), | 7 x 


3. the message "ERRORS DETECTED". 


If no errors are detected, then the assembly process continues 
with Pass 2, and the only output from Pass 1 is the label table 
listing. If no erroneous statements appear ahead of the label 
table listing, the source deck should again be put in the card 
reader's input hopper immediately behind the remainder of the 
Pass 2 assembler deck. During Pass 2, the object code is 
assembled and punched, and the assembly listing is printed. 
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Source Program 


Pass 2 Part 2 


Pass 2 Part | 
Label Table Print 


Source Program 


Assembler 
Parameter Cards 


Pass 1 Part 1 
(parameter processer) 


/ 


Loader 
* (supplied by user) 


Figure 5-1. Assembler | Job Deck 
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ASSEMBLER | (DISC VERSION) 
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The disc-resident assembler operates under the Disc Management 
Facility (DMF). The operation differs from that of the card 
version in two respects: 


1. The (optional ) assembler parameter statements are 
entered via the COMMAND logical unit (_LRDR). The 
device address of this logical unit is established by 
the ASSIGN function of DMF MAINT. The device address is 
originally zero if no prior assignment has been made. 


2. The immediate source input must be a DMF disc file. 
The operator controls the assembly process from the Workstation 


or Communications Terminal keyboard. At his. command, the 
FILE/REFILE program (part of DMF) reads his source deck into a 


DMF dise file of his choosing. At his command, Assembler I 


enters memory from disc to process any assembler parameter 
statements he enters in the keyboard. He follows his last 
parameter statement with a null statement generated by pressing 
any CTL key (on the Workstation) or entering control p control / 
(on the Communications Terminal). The assembly proper begins. 
Using the disc source file as input, the assembly is performed, 
the listing is printed on the listing device, and the object 
deck is generated on the object device (which may be a DMF file 
specified by the OBJECT= parameter card). 


The source deck passes through the card reader only once 
(instead of twice as with the card version). Once the assembler 
is installed, it is never again read through the card reader. 
Instead, it enters memory from the disc file where it resides 
permanently. This eliminates the possibility of dropping the 
assembler deck and simplifies card handling. 


Fixed Parameters 


Assembler I (Dise Version), like the card version of the 
assembler, is also furnished to the user as an object card deck. 
The first card in this deck contains the fixed assembler 


parameters used _ to specify input/output options, but the 
purposes of the entries in this card differ somewhat from those 
in the card version of the assembler. These entries are as 
follows: 

Card Column Entry 

8-10 Ignored. 

11 | Default disposition of symbol cross- 


reference listing (when no XREF= 
assembly parameter statement is used). 


Y Create listing. 


N = Suppress listing. (Original 
entry. ) 
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Card Column Entry 


L215 Lower bound of Label Table in Common 
Core. (Rightmost character must be 
an alphabetic character P to Y to 
indicate a negative number, and thus 
a Common Core address.) 


Lo=19 Upper bound of Label Table in Common 
Core. (Rightmost character must be 
an alphabetic character P to Y to 
indicate a negative number and thus, 
a Common Core address.) 


2OT2S Object card trailer control charac” 
ters. The assembler sends these 
characters (via the Write Control 
Mode) to the object device after 
each object card is generated. 


24-27 Maximum number of lines that can be 
printed on each page of listing output. 


28-29 Not used. 


30-37 Default date to go on assembly 
listing (if no DATE= assembly para- 
meter statement is entered). 
Typically, this entry is blank. 


38 | Default disposition of debug cards 
(if no DEBUG= assembly parameter 
statement is entered). 


$ = Ignore source cards con- 
taining $ in column 1. 
(Original entry.) 


* = Assemble source cards 
containing $ in column l. 


39 Default disposition of Common object. 
text. 


Y = Write Common object text 
in output. (Typical entry.) 


9 = Assemble Common object 
code, but suppress it 
from the object deck. 


40-46 Constants used by the assembler. 
47-70 | Not used. 
TL=79 | Program identification. 
77-80 Card sequence number OOO]. 
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Installing The Assembler 


Before installing the disc assembler, examine the first card 
(0001) of the assembler object deck to determine that it 
contains the fixed parameters) desired. After making any 
necessary changes, arrange the assembler deck with the necessary 
DMF cards as follows: 


(unit separator card: 11-7-8-9 punched in column 1) 


(unit separator card) 


disc resident assembler program 


FILE SYSPOL.ASMBLR 


poolname. filename 


NOTE: the assembler can be filed under any convenient 
poolname.filename. SYSPOL is the preferred pool because 
this permits the poolname to be omitted when the 
assembler is invoked. If no poolname is given, SYSPOL 
is implied. 


Then proceed as follows, interacting with either the Workstation 
or Communications Terminal console: + 


Operators: Place input deck in card reader. Get load condition 
on console. Depress ENTER key (on Workstation) or 
control / key (on Communications Terminal). 


Consoles: Prints: A) ENTER PROGRAM NAME 
Operator: Types FILE or REFILE. (Use FILE if 
poolname.filename entry on first input card 


identifies a new file. Use REFILE if the identified 
file already exists.) 


Depress: ENTER key (on Workstation) or control / 
key (on Communications Terminal). 


This procedure files the disc assembler object deck on disc. 
Upon successful completion, the console prints: 


A) ENTER PROGRAM NAME 
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Filing Source Deck 


To prepare for assembly, file the source deck on the DMF disc 
pack using the following deck setup. 


(unit separator card: 11-7-8-9 punched in column 1) 


(unit separator card) 


User's source program 


FILE poolname. filename 


Then, proceed as follows, interacting with the console on either 
the Workstation or Communications Terminals: 


Operators: Place input deck in card reader. Get load condition 
on console. Depress ENTER key (on Workstation) or 
control / key (on Communications Terminal). 


Console: Prints: A) ENTER PROGRAM NAME 


Operators: Types FILE or REFILE 
(Use FILE if poolname.filename on first input card 
identifies a new file. Use REFILE if the identified 
file already exists.) 


Depress: ENTER key (on Workstation) or Control / 
kéy (on Communications Terminal). 


This procedure files the source deck on disc. Upon successful 
completion, the console again prints: 


A) ENTER PROGRAM NAME 
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Assembling Source Program 


To assemble the user source program, call the dise assembler 
into memory and give the name of the file containing the source 
program, as follows: 


Operators Get load condition on console. 


Depress: ENTER key (on Workstation) or control 
/ key (on Communications Terminal). 


Consoles Prints: A) ENTER PROGRAM NAME 
Operators: Type: ASMBLR 


(If the assembler is not filed under 
SYSPOL.ASMBLR, give poolname.filename 
used to file it.) 


Depress: ENTER key (on Workstation) or control 
/ key (on Communications Terminal). 


The assembler now enters memory from disc and starts 
executing. Continue as follows: 


Console: Lights: Enter Light (on Workstation). 
Prints: E (on Communications Terminal). 


Operator: Elect to use input/output default options 
specified as fixed assembler parameters, or 
override these with new parameters. 


To use the default parameters, simply depress 
any control key (on the Workstation) or 
control p control / (on the Communications 
Terminal) and the assembly will begin. The 
default parameters normally result ins 
reading of the source input from the disc 
file SOURCE.TEMP, writing of common text 
output in the object code, ignoring of 

Debug statements, suppression of the symbol 
cross-reference listing, output of blanks for 
the date on the program listing, and output 
of the object program through the card punch. 
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To override any of these default options, 
enter any of the following assembler para- 
meter statements from the assembler 
command device. 


otatement Purpose 

DEBUG=YES To assemble Debug statements. 

DEBUG=NO To ignore Debug statements 
(the normal default para- 
meter). 

COMTXT=YES To permit generation of 


object code in Common Core 
(the normal default para- 
meter). 


COMTXT=NO To suppress generation of 
object code in Common Core. 


SOURCE=poolname. filename To specify a disc file as 
source input. (The default 
option is the disc file 
SOURCE.TEMP; if poolname is 
not specified, SOURCE will be 
assumed. ) 


OBJECT=poolname.filename To direct object output to a 
disc file. (The default 
option is the card punch; if 
poolname is not specified, 
SOURCE will be assumed. ) 


XREF=YES To request output of a symbol 
cross-reference listing. 


XREF=NO To suppress output of a 
symbol cross-reference list-— 
ing (the normal default 
option). 


DATE=mm/dd/yy To print a date in listing 
| headings. (The normal de- 
fault option is blanks.) 
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After each statement, depress the ENTER key 
(on the Workstation) or control / key (on the 
Communications Terminal). If the 
OBJECT=poolname.filename statement is used 

to direct object output onto disc, the disc 
file specified must initially be a null file. 
The disc pack used must contain the necessary 
DMF routines (the low core, locator, and disc 
loader programs). (For further directions, 
see the Disc Management Facility User's 
Reference Manual.) If a mistake occurs during 
entry of any of the statements, depress 

the ENTER key (on the workstation) or the 
control / key (on the communications termin- 
al) and re-enter the statement. 


To commence assembly, depress any CTL key (on 
the Workstation) or control p control / (on the 
Communications Terminal). The assembler will 
process the source program designated by the 


SOURCE=poolname.filename statement. If this 


statement is omitted, the default file 
SOURCE.TEMP is used. 
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APPENDIX A: ASSEMBLER DECK PARAMETERS 


ASSEMBLER | (CARD VERSION) 


Parameter : 
iene 


Effect on Equivalent Assembler 

Assembly Parameter Statement 
Takes input from 
card reader. 


10 Transmits object 
program to card 


punch. 


Object Device No. 


Listing Device No 2 Transmits listings 
to line printer. 
Vi 


2- 15 Lower bound of label 0000 Declares no boundary. 
table in Common Core. 
16 - 19 Upper bound of label 0000 Declares no boundary. 
table in Common Core. 
20 - 23 Object card trailer SMbb 
control characters. 
24 - 2/7 Maximum number of 
lines printed on 
listing page. 


38 Default disposition Ignores Debug cards.}| DEBUG= NO 
i 


| 


Default disposition Punches Common COMTXT=YES 
of Common object object text. 


text. 
40 - 46 Constants used by (Must not 
the assembler. be 


changed) 


71 - 7/6 Program identifier. a 


77 - 80 Card sequence number 
0001. 


OO 
LO 
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APPENDIX A: ASSEMBLER DECK PARAMETERS 


ASSEMBLER | (DISC VERSION) 


Parameter 
Card Column 


Meanin Normal Effect on Equivalent Assembler 
J Entry Assembly Parameter Statement 


Not used. 


— 
— 


© 
1 

— 

© 


Default Disposition 
of Symbol Cross- Cross-Reference 
Reference Listing. Listing. 


12 - 15 Lower bound of label 0000 Names no boundary. 
table in Common Core. 
16 - 19 Upper bound of label 0000 Names no boundary. 
table in Common Core. : 
20 - 23 Object card trailer SMbb 
control characters. 
24 - 2/ Maximum number of 
lines printed on 
each listing page. 
30 - 37 Default date printed Blank 
on listing. 
38 Default disposition $ 
of debug cards. 
39 Default disposition Y 
of Common object 
text. 


Constants used by (Must not 
the assembler. be 


changed). 


Suppresses Symbol 


40 - 46 


71 - 76 Program identifier 


Card sequence number 
0001 


77 - 80 
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APPENDIX B: 


INSTRUCTION NAME 


Add 

Divide 

Form Numeric 
Multiply 
subtract 


Compare 
Exchange 

Edit 

Move Character 
Move Numeric 


Read 
Write 


BRANCH 
Conditional 
Link 


Service Request 


Unconditional 
Switch 
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1011 
1011 
1011 
1011 
LOLI 


OP CODE 


BC 
BC 
BC 
BC 
BC 


B-] 


OPERAND FORM 


Af TAs TA) BCLBs TB) 


MACHINE INSTRUCTION STATEMENTS 


FORM NAME 


Two-length 
form 


One-length 


form 


Device/ 
Channel 
form 


Branch 
form 


Assembler I 


APPENDIX B: 


LEGEND (for Machine Instructions) 


A,B Address-A, Addres 


permissible fo 


s/Count-B 


rms ¢ 


MACHINE INSTRUCTION STATEMENTS 


symbol 
symbol constant 
(flagged) constant 
(flagged) constant constant 
* 
* constant 
C Channel and Control (range O-5) 
(O-FAC, 1-I0C, 2-FAC-control, 3-I0C-control, 
5=10C=non=fi11)) 
D Input/Output Device (range 0-9) 
IA,IB Index register (range 0-3, O = no indexing) 
L Length (range 1-100) 
LA, LB Length (range 1-10) 
V Branch variant 
O---no branch 
1---branch if condition code is l 
2---branch if condition code is 2 
S---branch if condition code is 3 
A---branch if condition code is 4 
5---~branch unconditionally 
8---branch and switch unconditionally 
9---no branch. 


INTERNAL INSTRUCTION FORMAT 


Assembler I 


CHARACTER[) 0 1 2 


LA }A3 | A2 


Al 


B-2 


Pp, 3 4A 5 6 JF 8 9 
[efron rao 


Omocoe 
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APPENDIX C: ASSEMBLER COMMANDS 


COMMON 


END 


EJECT 


EXEC xXXXX 


NORMAL 
label ORG ‘XxXxXX 
SPACE xx 


TITLE ‘text---up to 60 characters’ 


Define Memory (assembler instruction) 


label DM RTS'DATA'(L,I) 
LEGEND 
R Repetition factor (range: O0-9999) Optional 
ik Data Type REQUIRED 
C: character 
Ns numeric 
As address 
S Size of DATA (range: 1-9999) Optional 
DATA Initialization data Optional 
L Length specification for label table 
(ranges: 1-100) Optional 
I Index register specification for label 
table (range: O-3) Optional 
RULE 
R times S may not exceed 9999. 
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APPENDIX D: 


CONDITION CODES 


ae 


BRANCH CONDITIONAL 


1-71 


COMPARE 


DIVIDE 


EDIT 


EXCHANGE 


FORM NUMERIC 


MOVE CHARACTER 


MOVE NUMERIC 


MULTIPLY 


READ 


SUBTRACT 


WRITE 
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D-1 


Zero 


Zero 


always 
set 


Zero 


always 
set 


always 
set 


Zero 


Normal 


Zero 


Normal 


Fault 


Overflow 


Fault 
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APPENDIX E: I/O DEVICE CONTROL CHARACTERS 


Card Reader , Local Query 


Card Punch _ (underscore)|Punch Unit Separator 


Ip Or: J Feed a Card 

Local Query 

Line Printer set Vertical Tab Register 
Advance Paper 
Skip to Top-of-Form 
Local Query 

Magnetic Tape Write Tape Mark 
Rewind 
Backspace Block 
Forwardspace Block 
Erase 
Change Mode 


switch to Local 
(and Rewind) 


"Read Only" Query 
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APPENDIX F: 


Possible 


Condition Codes 


Card Reader 


2 (NORMAL) 


3 (FLAG) 
4 (FAULT) 
Card Punch 


2 (NORMAL) 


4 (FAULT) 


Line Printer 
2 (NORMAL) 


3 (FLAG) 


4 (FAULT) 
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I/O DEVICE CONDITION CODES 


PmAdD 


and l 


OK. 
Unit Separator character read. 


? sent by a Write Control instruction 
when the card reader was in Local, card 
reader addressed by a Write instruction, 
card reader's power off, or card reader's 
buffer is empty. 


OK. 


? sent by a Write Control instruction 
when the card punch was in Local, or card 
punch addressed by a Read instruction, or 
card punch's power off. 


OK. 


Write operation or skipping operation 
completed just as the bottom of the 
page was sensed. 


? sent by a Write Control instruction 

when the line printer was in Local, or line 
printer addressed by a Read instruction, or 
line printer's power off. 


F-1 Assembler 
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APPENDIX F: I/O DEVICE CONDITION CODES 


Disc 


1 (ERROR) Error during reading, or seek to an 
invalid track. 


2 (NORMAL) OK. 
5 (FLAG) Error during writing. 
OR 
Tried to read a "bad" sector. 


4 (FAULT ) Dise drive not ready. 


Magnetic Tape Read Operation 


1 (ERROR) Parity error(s) detected. 
2 (NORMAL) OK. 
5 (FLAG) Tape Mark read and no parity errors 


were detected. 
OR 


Oversized record encountered and no 
parity errors were detected. 


4 (FAULT) Tape drive was switched to Local 
during the Read operation. 


OR 
Another tape drive with the same 
address was switched On-Line during 
the Read operation. 


OR 


Tape drive not ready. 
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APPENDIX F: I/O DEVICE CONDITION CODES 


Magnetic Tape Write Operation 


1 (ERROR) Parity error(s) detected. 
2 (NORMAL) OK. 
53 (FLAG) End-of-Tape reflective marker sensed and 


no parity errors were detected. 


4 (FAULT) Attempted to write on a "Read Only" 
tape. 


OR 


The tape drive was switched to Local 
during the Write operation. 


OR 
Another tape drive with the same address 
was switched On-Line during the Write 
operation. 


OR 


Tape drive not ready. 


Magnetic Tape Control Operation 
2 (NORMAL) OK. 


5 (FLAG) Tape Mark was spaced over during either 
Forwardspace Block or Backspace Block. 


OR 


D sent by a Write Control Instruction 
when a “Read Only" tape was mounted. 


4 (FAULT) The tape drive was switched to Local 
_during the control operation. 


OR 


The tape was already positioned ata 
load point when backspacing was requested. 


OR 


Tape drive not ready. 


11-71 F-3 Assembler I 


© 1971, The Singer Company 


APPENDIX G: STANDARD DEVICE NUMBERS 


TOC 


FAC 


O Workstation 


1 Card Reader 


2 Line Printer 


3 Paper Tape Reader 


4 Card Punch 


6 Paper Tape Punch 


7 Workstation 
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Disc Controller 


Magnetic 
Magnetic 
Magnetic 


Magnetic 


Tape 
Tape 
Tape 


Tape 


Drive 


Drive 


Drive 


Drive 


On Line Communications Adapter 
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APPENDIX H: DISC ADDRESS 


Bit-7 of each character may be either ON or OFF. 
Bit-5 of each character must always be ON. 


sectors 00-49 are accessed by the upper of the two heads on each 
arm and sectors 50-99 by the lower. 


The lowest of the five arms iS number 4 and 
the uppermost is O. 


The outermost track is number OOO 
and the innermost is 199. 


jawrevr [> J*@ se tetels 


Az Device number (0-9). 

Bf Arm number (0-4). 

C: Hundreds Digit (O or 1) of a three-digit track number. 
D: Tens digit (0-9) of a three-digit track number. 

E: Units digit (0-9) of a three-digit track number. 

F: Tens digit (0-9) of a two-digit sector number. 


G: Units digit (0-9) of a two-digit sector number. 
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APPENDIX |: CONVERSION TABLES 


SYSTEM TEN 
INTERNAL CODE 


CHAR- NAME OF HOLLERITH 
ACTER CHARACTER CODE 


SPECIAL | 
INTERPRETATION 


SW OO 
no 
Po 
wo 
row 
- oO 


W-71 
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Exclamation point 12-8-/7 


ee 
frre tsi ea 
Yomens tins in| 
7 


<— a 
a 


Appears as!(logical or on 
IBM 029 Keypunch board. 


Prints as £on some 
Model 50 Line Printers. 


Assembler I 


APPENDIX |: 


CONVERSION TABLES 


SYSTEM TEN CHAR- NAME OF 
| INTERNAL CODE ACTER CHARACTER | 


Assembler J 


x4 


— 

NO 
i 

ol 


HOLLERITH 
CODE 


7 


ee) 
Ro 


11-8-6 
12-8-4 


0-8-6 
0-8-7 
8-4 


a rs ee ee es ee | 
NM | pr |] pr |] po 
i i 1 1 
BP lowlni — 


ad 

Ro 
I 

Lo>) 


—! 

Po 
i 

™ 


a 
i. 
oe) 


J 

— 
1 

= 


SPECIAL 
INTERPRETATION 


Prints as # on some Model 50 
line printers. 


Can also be used internally 
as -0. 


Can also be used internally 
fas <1. 
Can also be used internally 
as -2. 
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APPENDIX |: CONVERSION TABLES 


SYSTEM TEN CHAR- NAME OF HOLLERITH SPECIAL 
INTERNAL CODE ACTER CHARACTER CODE INTERPRETATION 
eS I a A SE GE I GP EL TRE PSE AOI 


b bb bbb 
754321 
110011 Can a be used internally 


as - 
110100 Can also be used internally 
as -4. 

110101 Can ee be used internally 
as - 

110110 Can ae be used internally 
as - 

1710777 Can ae be used internally 
as - 

111000 Can also be used internally 
as -8. 


111001 Can also be used internally 


aad -9, 


111010 


Opening bracket 12-8-2 

Reverse slash Appears as 0-2-8 key on 
IBM 029 Keypunch board. 

Closing bracket 11-8-2 Appears as | on IBM 029 
Keypunch ey 


11-8-7 Appears as — (logical not) 


on IBM 029 Keypunch board. 
— i 


LP AO 14 SE as ¢ on IBM 929 


Keypunch board. 


/ 


11117100 


1171101 


Lob ab oh 0 


Prints as 4 on some Model 50 
Line Printers. 


TT T1711 


Prints as < on some Model 50 
Line Printers. 
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APPENDIX J: BOOTSTRAP CARD AND FOUR-CARD LOADER 


Bootstrap Card and 4 Card Loader 
00010102901 BUOTSTRAP CARD **UISE IF CARD! READER 1Si DEVICE xs 
?P00P010070P0PP0501 30: Q000 0000 (OP 1X940182:1P188401820010110080R0WY050070 
(001W710008. * '1P085400311P12040045PPP0TOP189ROQU050110P003010010Rk001170012 


POPPO50050% OOO00TS1OPPU7740182RORQ050090PPQ01 10186RORSO50260P010350255P01P 210250. 
poder ogoorrues BOLE? RURMO20OG Or OL es er er Unrongueuouvrere? 


60 7 BO 
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GLOSSARY 


GLOSSARY 


INTRODUCTORY NOTE 


11-71 


The purpose of the Glossary 


is to define all new 


terms 


introduced in the text and to define any special use made of 


standard terms. 
sense are not included. 


Standard terms 


For elucidation on these, 


referred to Computer Dictionary and Handbook by Charles J. 


(Howard W. Sams & Co., Inc., 


Indianapolis, 1966). 


Following is a list of the items defined in the Glossary: 


Alphabetic Field 


Arithmetic and Control Unit 


(ACU): 
Auxiliary Storage 
Block 
Bootstrapping 
Branch 
Buffer 
Burst Mode Transmission 
Byte 
Byte Mode Transmission 
Central Processing Unit 

(CPU) 
Channel 
Characters 
Common Area of Memory 
Control Character 
Control Field 
Cycle-Stealing 
Disc, Bound 
Disc, Free 
Double Frame 
Effective Address 
File 
Filler Characters 
Flagged Constant 
Flowcharting Symbols 
Hexadecimal Number System 
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Host Partition 
Implied Parameter 
Index Register 
IOC 

Label Table 

Link 

Literal 

Local Mode 

Main Memory 
Memory Module 
Mixed Field 
Multiprogramming 
Numeric Field 
Object Program 
On-Line Mode 
Operation Code 
Overdraft 
Overflow 

Parity Bit 
Partition 
Partition Switching 


Privileged Area of Memory 


Protected Area of Memory 
Return Address 

sector 

source Program 

Symbol 

USASCII 


which are used in a standard 
the reader is 


Sippl 
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A 


Alphabetic Field 


A field consisting strictly of the alphabetic characters A thru 
Le 


Arithmetic and Control Unit (ACU) 


In System Ten, that part of the Central Processing Unit (CPU) 
which controls’ and performs the execution of machine 
instructions. 


Auxiliary Storage 


Block 


storage in addition to the main storage of a computer. 
Auxiliary storage usually holds much more information than the 
main storage, and the information is accessible less rapidly. 
In System Ten, the disc is considered to be auxiliary storage. 


When used in connection with the Friden Model 45 Magnetic Tape 
Drive, block means a series of consecutive tape characters. The 
end of one block and the beginning of the next is signalled by a 
segment of blank tape called an inter-block gap. By this 
definition, block is synonymous with the phrase "physical 
record." 


Bootstrapping 


Branch 


Assembler J 


A technique for loading the first few instructions of a program 
into storage, then using these instructions to bring the rest of 
the program into storage. This sometimes involves either the 
manual entering of a few instructions or the use of a key on a 
console. In System Ten, the bootstrap sequence is initiated by 
the depression of a LOAD button on an input device or by the 
occurrence of certain errors during program execution. 


In System Ten, a departure from the normal sequential processing 
of instructions as caused by the execution of the Branch 
instruction. Another type of departure from sequential 
processing is the switch which passes control to a neighboring 
partition. 
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Buffer 


Temporary storage used to compensate for the difference in 
operating speeds of input/output devices and the Central 
Processing Unit (CPU). In System Ten, the card reader has two 
card buffers, the card punch has three card buffers, the line 
printer has two line buffers, etc. Each IOC has one character 
buffer. 


Burst Mode Transmission 


A mode of communication between the Central Processing Unit 
(CPU) and external input/output devices. The information is 
transmitted without interruption as a solid procession of binary 
bits. In System Ten, the burst mode is employed in transmitting 
between Main Memory and the Friden Model 40 Disc Drive. 


Byte 


In System Ten, a group of 6 adjacent binary bits. The bits are 
referred to as bit-7, bit-5, bit-4, Dit=5:-5 biavpeH2 4 and bit-l. 
Bit-6 of the USASCII Standard Code is not used. 


Byte Mode Transmission 


A mode of communication between the Central Processing Unit 
(CPU) and external input/output devices. Transmission proceeds 
-one character at atime on a cycle-stealing basis. In System 
Ten, all transmission through the Input/Output Channel (IOC) is 
accomplished in this mode, as is also transmission through the 
File Access Channel (FAC) when the Friden Model 45 Magnetic Tape 
Drive is the input/output device. | 


Central Processing Unit (CPU) 


In System Ten, the Central Processing Unit (CPU) comprises the 
Arithmetic and Control Unit (ACU), the File Access Channel 
(FAC), one to twenty Input/Output Channels (I0C), and Main 
Memory. 


Channel 


A path along which information, particularly a series of bits or 
characters, may flow. In System Ten, each partition has a 
private Input/Output Channel (IOC) which transmits in the byte 
mode. Common to all partitions is a single File Access Channel 
(FAC) which transmits in the burst mode when the dise is used. 


Characters 


A set of coded symbols that includes the decimal digits O thru 
9, letters A thru Z, punctuation marks, operation symbols, and 
other symbols. In System Ten, each character is represented by 
6 binary bits. 
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Common 


Area of Memory 


In System Ten, that portion of memory which is not partitioned. 
The Common Area comprises Protected Storage (locations 0-299), a 
Non-Privileged area, and an optional Privileged area accessible 
only to privileged partitions. 


Control Character 


Control 


A character whose occurrence in a particular context initiates, 


modifies, or stops a control operation. 


Field 


In System Ten, the second operand used by the EFdit instruction. 
The control field governs the format of the edited result. 


Cycle-Stealing 


Data channels give the Arithmetic Control Unit (ACU) the ability 
to delay the execution of a program for communication of an 
input/output device with memory. If an input unit requires a 
memory cycle to store data that it has’ collected, the data 
channel makes it possible to delay the program prior to the 
execution of an instruction, and to store the data without 
changing the logical condition of the ACU. After the data is 
stored, the program continues as though nothing has occurred. 
In System Ten, cycle-stealing occurs between instructions, and 
during the transmission of data between magnetic tape and 
memory. oe . 


Disc, Bound 


In System Ten, a dise is bound to a given partition as soon as 
the partition institutes a seek upon it. The disc remains bound 
until data transmission is complete. While a disc is bound to a 
given partition, it cannot be accessed by another partition. 


Disc, Free 


In System Ten, adisec is free when it is not bound to another 
partition. 


Double Frame 


Assembler I 


In System Ten, a special method of reading or writing 9-track 
magnetic tape in which the eight bits of data in each tape row 
are constructed from (or read into) the numeric portions of two 
consecutive locations in main memory. The same method can also 
be used on eight-~channel paper tape readers and paper tape 
punches. 
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11-71 


Effective Address 


The address that is actually used in a particular execution of 
an instruction. In System Ten the effective address for a given 
instruction address field is the sum of the address field added 
to the contents of whatever index register is associated with 
that field. 


File 


When used in connection with the Friden Model 45 Magnetic Tape 
Drive, file means a series of consecutive blocks (or “physical 
records"). The end of one file and the beginning of the next is 
Signalled by a special two character block called a Tape Mark. 


Filler Characters 


All characters used in the edit machine instruction EXCEPT the 
'at' sign (@), Slash (/), dash (-), comma (,), and decimal point 


(-)- 
Flagged Constant 


In System Ten Assembler-l Language, a constant with a C or P 
appended to indicate a common or partition address. E.G., 495C, 
4567P. 


Flowcharting Symbols 


SYMBOL REPRESENTS 
PROCESSING 
A group of program instructions which 
perform a processing function of the program. 


DECISION 


The decision used to document points in the 
program where a branch to alternate paths is 
possible based upon variable conditions. 


TERMINAL 


The beginning, end, or point of interruption 
in a program. 


CONNECTOR 


An entry from, or an exit to, another part 
of the program flowchart. 


FLOW DIRECTION 


The direction of processing or data flow. 
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Hexadec 


imal Number System 


A number system using the equivalent of the decimal number 
Sixteen as a base. In System Ten, the digits greater than 9 are 
written as 10, 11, 12, 13, 14, 15. 


Host Partition 


The partition in control when the given instruction is executed. 


Implied Parameters 


Index Re 


lOC 


The length and index register parameters associated with a label 
in the label table. Whenever a label appears in the operand 
field of a statement using length and/or index parameters, the 
length and index register parameters may be omitted and they 
will be supplied automatically from the label table. Thus the 
idea that, by being omitted, the parameters were “implied." 


gister 


A register whose primary purpose is to modify addresses in 
computer instructions. In System Ten there are three index 
registers in each partition. They are referred to by number and 
occupy partition storage locations 11-14 (index register 1), 21- 
24 (index register 2), and 31-34 index register 3). 


An abbreviation for Input/Output Channel on the System Ten. 


Label Table 


Link 


Assembler I 


A table produced by the assembler which contains, for every 
label in the source program, the address assigned to the label 
by the assembler, an indication as to whether the address is in 
common or partition, an implied length associated with the 
label, and the implied index. 


In System Ten, a variant of the Branch instruction ordinarily 
used in calling subroutines. Link first establishes a return 
path from a subroutine and then passes control to the beginning 
of the subroutine. 
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GLOSSARY 


Literal 
An item of data with its value as stated. The assembler permits 
the use of a literal in the text field of the TITLE assembler 
command and in the data field of the DM (Define Memory) 
assembler command. Literals are not used in the machine 
instruction statements. 

Local Mode 


The mode in which data may NOT be transmitted between a device 
and an Input/Output Channel (IOC). 


Main Memory 


Memory 


In System Ten, the entire core storage. This includes the 
storage occupied by all partitions as well as the entire common 
region which includes the protected area, the non-privileged 
area, and the privileged area. 


Module 


In System Ten, the minimum unit of core storage. A Memory 
Module contains 10,000 character positions. In System Ten, core 
storage may contain 1-11 Memory Modules. 


Mixed Field 


A field which may include any combination of characters 
including, for example, alphabetic, numeric, and punctuation 
characters. In System Ten, a field prepared for printing by the 
Edit instruction is usually a mixed field. 


Multiprogramming 


A technique for handling numerous routines or programs 
Simultaneously by overlapping or interleaving their execution. 
In System Ten, the programs being executed simultaneously each 
reside ina separate memory partition. Multiprogramming is 
achieved by passing control from one partition to another in 
round-robin sequence. 


Numeric Field 


A field containing numeric information and sign indication. 
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O 


Object Program 


The machine-language representation of a source program. If a 
source program contains no errors, detectable by the assembler, 
it is translated to machine-language; the object program is what 
results from this translation process. 


On-Line Mode 


The mode which permits the transmission of data between a device 
and an Input/Output Channel (IOC) or File Access Channel (FAC). 


Operation Code 


The part of a System Ten machine instruction which specifies the 
operation to be performed. 


Overdraft 


In System Ten, an intermediate condition which sometimes occurs 
in the subtraction process. Not to be confused with Overflow, 
which yields a wrong answer. 


Overflow 


In System Ten, an erroneous result caused by an attempt to 
develop an answer too large for the field assigned to it. , 


Parity Bit 


A binary digit (i.e., either O or 1) appended to a string of 
bits to make the sum of all the bits which are ON either always 
odd or always even. 


Partition 


In System Ten, a portion of core storage. A system may contain 
1-20 partitions. Each partition has 3 index registers and an 
Input/Output Channel (IOC). Partitions may communicate with 
each other only through common storage or devices on the File 
Access Channel (FAC). 


Partition Switching 


In System Ten, an automatic process by which control passes from 
one partition to its neighbor. Partition Switching consists 
essentially of saving status information necessary to resume the 
program which is relinquishing control, selecting the partition 
which is to gain control, restoring its Condition Code, and 
passing control to the appropriate instruction within it. 
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Privileged Area of Memory 


In System Ten, an optional hardware setting that reserves an 
upper portion of common storage for use by privileged partitions 
which are designated when the option is set. 


Protected Area of Memory 


In System Ten, locations 0-299 of the common storage area. 
Programs cannot store information in this area which is used by 
the ACU to keep information pertinent to partition switching and 
input/output operations. A program may examine information in 
the protected area even though it cannot (directly) alter it. 


Return Address 


In System Ten, the address of the instruction to which control 
returns after a particular execution of a subroutine. 


Sector 


A sector is one-fiftieth (1/50th) of a track on the Friden Model 
40 Dise Drive. Each sector holds 100 characters (each 
consisting of 6 bits). Reading and writing on the disc is 
always done in groups of 100 characters. 


Source Program 


A program coded in other than machine-language, and which must 
therefore be translated into machine-language by an assembler or 
compiler before it can be executed. The assembler processes a 
source program coded in assembler language and translates it 
into an object deck. 


Symbol 


A group of from one to six characters. The first character 
must be one of the alphabetic characters A through Z, or one of 
the special character (\)*or _. The others can be any of these 
alphabetic or special characters, or the digits O through 9. 


USASCII . 


A contraction for "United States of America Standard Code for 
Information Interchange." This standard defines the graphics 
and codes for a128- character set. Commonly referred to as 
ASCII. 
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Add instruction, 2-2 to 2-3 
Alignment 
data fields, 3-7, 3-17 
instruction, 1-19, 3-17 
Assembler commands, 1-29, sec 3, app C 
COMMON, 3-2 to 3-3 
DM (Define Memory), 3-4 to 3-10 
EJECT, 37-11 
END, 5-12 
EXEC, 3-13 
NORMAL, 3-14 to 3-15 
ORG, 3-16 to 3-17 
SPACE, 3-18 
TITLE, 3-19 
Assembler deck parameters, sec 5, app A 
Assembling source programs 
card version, 5-4 to 5-6 
disc version, 5-11 to 5-13 
Assembly process, overview, 1-7 to 1-8 
Asterisk as address, 1-12, 3-3, 3-15 
Auxiliary software, 1-5 


Bootstrap card and four-card loader, app J 
Branch instruction, 2-4 to 2-9 


Channel indication, 2-27 
Character set, 1-12 to 1-13, 2-12 
Coding forms and source cards, 1-17 to 1-18 
Commands, assembler, 1-29 to 1-30, sec 3 
Comments field, 1-16 
Comments statement, 1-17 
COMMON assembler command, 3-2 to 3-3 
Common indication, 1-22 to 1-24 
Common/partition specification, 1-27 to 1-28 
Compare instruction, 2-10 to 2-12 : 
COMTXT=YES, COMTXT=NO (assembler parameters), 5-4, 5-12, 
app A 
Condition codes 
I/O device, app F 
machine instructions, app D 
Constants and symbols, 1-22 to 1-24, 3-2, 3-14 
Control characters, I/0 device, app E 
Control statements, 1-29 to 1-30, sec 3, app C 
Conversion tables, app I 
Cross-reference listing, 4-7 
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DATE=mm/dd/yy (assembler parameter), 5-4, 5-12, app A 

Debug statement, 1-17 

DEBUG=YES, DEBUG=NO (assembler parameters), 5-4, 5-12, app A 
Deck structure, 1-9 

Device numbers, app G 

Diagnostics, 1-19, 4-2 

Disc address, app H 

Divide instruction, 2-13 to 2-14 

DM (Define Memory) assembler command, 3-4 to 3-10 


Edit instruction, 2-15 to 2-18 
EJECT assembler command, 3-11 

END assembler command, 3-12 

Error messages, 4-8 

Error statement listing, 4-1 to 4-4 
Exchange instruction, 2-19 to 2-20 
EXEC assembler command, 3-13 


Fields, source statement, 1-14 to 1-16 
Flagged -constant, 3-14, Glossary-5 
Form Numeric instruction, 2-21 to 2-22 
Format, statement, 1-12 


Identification field, 1-16 
Implied operand forms, 1-24 
Index register specification, 1-28 
Instruction alignment, 1-19 
Instruction fields, 1-26 to 1-29 
I/O device condition codes, app F 
I/O device control characters, app E 
I/O device numbers, app G : 
I/O device requirements, 1-3 to 1-5 
card version, 1-3 
disc version, 1-5 


Label field, 1-14 to 1-15 

Label table, 1-9, 4-5, Glossary-6 

Link variant of branch instruction, 2-7, Glossary-6 
Listing output, 4-1 to 4-7 

Literal, Glossary-7 

Loader, App J 

Loading, 3-13, 4-9 
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Machine instruction statements, 


Add’, 2-2 to 275 
Branch, 2-4 to 2-9 
Conpare,.-2-L0 -to. 2-12 
Divide, 2-13 to 2-14 
Badits,. 2-15 “to 2-18 
Exchange, 2-19 to 2-20 
Form Numeric, 
Move Character, 2-23 
Multiply, 2-25 to 2-26 
Read, 2-27 to 2-32 
subtract, 2-33 to 2-34 
Write, 2-35 to 2-40 
Memory assignment counters, 
Memory requirements, 1-2 
Move Character instruction, 
Move Numeric instruction, 
Multiply instruction, 


NORMAL assembler command, 


Object deck formats, 4-9 
Object listing, 4-1 

Operand field, 1-16 

Operand forms, 
Operation field, 1-15 
ORG assembler command, 
Overlay structure, 


Parameter statements, 
Parameters, assembler 
card version, 5-l 
dise version, 5-7 


Program listing, 


Read instruction, 
Return address, 2-8 
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Program identification field, 
4-6 to 4-7 
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1-6, sec 2, app B 
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3-17 


2-29 


2-24 
2-20 GO -2=26 


5-14 to 3-15 


3-16 to 3-17 
110s 0: cot 
Overview of assembly process, 


Ley 0 3 


sec 5 


2-27 to 2-32 
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s card, 4-9 
sequence number field, 1-16 
service request, variant of branch instruction, 2-9 
software required, 1-5 
Source deck structure, 1-9 
source statement fields, 1-14 to 1-16 
SPACE assembler command, 3-18 
Standard device numbers, app G 
start address 
loading, 3-13 
subroutine, 2-8 
Statement format, 1-12 
Statement repertoire (machine instructions), 1-6, sec 2 
subtract instruction, 2-33 to 2-34 
Symbol, Glossary-9 
Symbol cross-reference listing, 4-7 
Syntactical errors, 1-19 
system Ten character set, 2-12 


T card, 4-9 
Tens boundary alignment, 1-19, 3-17 
TITLE assembler command, 3-19 


USASCII, 1-12, Glossary-9 
USASCII code chart, 1-13 
Using the assembler, sec 5 
card version, 5-1 to 5-6 
6 ae 


disc version, 5-7 to 3 


Write instruction, 2-35 to 2-40 
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